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The deadline for 
the next issue is the 
Ist of May 2006 


Norman Dunbar has confessed. It was not so much a confession as a public decla- 
ration of guilt. In the headline to his DocBook article in the last issue of QL Today he 
used the dreaded words “Off Topic’. 


As it happens we disagree with him. Jochen added a note that the article was re- 
levant because his work was to be found on the ‘Insider CD” that came with the last 
issue. Even without the “Insider CD" | think we were still right to use the article. In the 
QL community we are too few in numbers to justify the expense of professionally 
printed documents. Norman’s article was relatively short and contained valuable in- 
formation on how we can improve the appearance of our documentation. 


"Off Topic’ also raises its head in this issue in the third part of the “Internet on the 
QL’ series. Cynics who read this may accuse us of wanting to change the title of 
the magazine to ‘Linux Today’. We did have problems with this article because of its 
length and technical content and, for reasons of space, decided it was unsuitable 
for the last issue. Nevertheless, we have readers who wish to access the internet 
from a Q40 or a Q60 and for them this article could be valuable. 


Nor are our problems over We have long wanted more articles on hardware and 
have been promised a series. However, these are long, technical and, more impor- 
tant, do not begin with QL hardware, but with other Sinclair machines. The author 
has reminded us that on our cover we claim to be "The Magazine about QL, QDOS, 
Sinclair Computers, SMSQ...” and therefore maintains his first articles are not “Off 
Topic’. He may have a point. Our cover aims give us some flexibility and we have 
readers who are interested in modifying other Sinclair computers. 


Sometimes we have to say ‘no’. Last year we received an article from a skilled 
C-programmer, which, although of high quality, we felt was unsuitable for QL Today. It 
was |ust too long, too technical and had no direct relationship to the QL. 


| am a person who enjoys testing boundaries, but that means | need keeping in 
control. The boundaries between what is and what is not “off topic” are not clear 
cut, and we shall not always get it right. Important factors are the length of an article, 
its technical nature and how far the content is of interest to QL-ers. We would wel- 
come the views of our readers about what is and what is not “off topic’. 


If you have written an article or would like to write one you fear may be “off topic’, 
please contact us for advice. We may be able to suggest changes to make it more 
relevant for our readers. 


A trouble free Year 
Marcel Kilgus has announced a update of QPC 
Print, which now supports landscape printing. It 
can be downloaded by registered users from his 
web site: 

http://www. kilgus.net/qpcprint/downloads.himl 

The download is protected and users should first 
note their registered name and number which can 
be found by clicking on the ABOUT button in 
QPC Print. They should then follow the instruc- 
tions on the web site. The download file is 1.53Mb. 
QPC Print has now been available for over a 
year and appears to be a trouble free program. 
Traders report they have had few queries from 
purchasers and the Quanta 
heloline only one request for 
helo. One program that has 
caused some difficulty is | 
Archive, but usually these pro- 
blems can be solved by using 
the spoolon and spooloff com- 
mands. 

QL Today would like to run a 
trouble shooting article on QPC 
Print and would be pleased to 
hear about readers’ 
experiences. 


XCHANGE 


Improvements 
Recently Marcel Kilgus has 
been updating Xchange almost 
faster than QL Today can keep 
up with him. Version 3.90N can 
be downloaded from his website: 
http://www. kilgus.net/smsqe/xchange.htm! 

You will need a minimum resolution of 512 x 512 

to use this version. 

There have been four main improvements since 

version 3.90L. 

1: Changes to the colour drawing routines to 
make them colour mode agnostic. Quill’s 
status area now uses a slightly diffferent font 
colour in high colour mode to differentiate it 
from the edited text. 

2: An extended working area with the main 
window twice as high as before. 

3: All modules now accept the DOS separator. 
Thus “quilldoc” is recognised as well as 
“quill.doc’. 

4: An Archive form feed bug has been fixed. 


Unlike the original Psion Archive, the Xchange 
version did not ignore the ‘lines per page’ 
feature in the printer driver This gave pro- 
blems to some users. 
In this connection Marcel reminds us that printer 
drivers work in a different way in Xchange from 
the original Psion programs. 
It Is possible for each of the programs in 
Xchange to have its own orinter driver, 
(archv_dat, abba_dat, quil_dat) or to have a 
generic driver (xchange_dat). 
When Xchange starts to print it first looks for the 
individual program driver and, if it does not find 
this, then prints using xchange _dat. 


QL Pin-Ups 

New on Dilwyn’s site is a calendar printing 
program. Dilwyn writes: 

“MultCal is a new Calendar printing program by 
Dilwyn Jones. The freeware program goes a step 
further than most QL calendar makers in that it of- 
fers a choice of 6 layouts including 12 month per 
page, planners and diary layouts, is written in 
documented uncompiled BASIC to let you modify 
it to your requirements, can print calendars star- 
ting on any day of the week and also lets you 
save the calendar as a plain text file for import 
into a word processor or DTP program if you wish 
to tart up the calendars a bit with various fonts 
and text sizes, or add pictures etc. Of course, it 
will print the calendar too. 6 sample plain text files 
generated with the program are included. 


Multi-Cal may be downloaded from text file transfer. This little program cid character 
http://www.dilwyn.uk6.net/utils/index.html set conversion, adding and removing carriage 
Also available is the QaLendar 2006. This is a returns, removing email quote symbols and all the 
QL-orientated calendar you can download, in — other little jobs that made it easier for a maga- 
Word DOC format, and includes pictures of some zine editor to strip down emails into usable text. 
well known QL personalities (but don't let that put ‘I've now converted it to GD2, or more specifically 
you offl), Wman 2 - it uses your current system palette co- 
QaLendar 2006 Is available for download from: lour theme, so you Can use it in your established 
http://www.dilwyn.uk6.net/gen/calendar/calendar.html colour theme for consistent appearance with 
< eee oe _... your other programs. 

| The program is freeware and available from 
my web site: 

| www.dilwyn.uk6.net/filetran/index.html 


| Yet more Dilwyn 

| Finally Dilwyn announces that the 

| Computer One Pascal manual is now on 

| his site: 

' "Derek Stewart has kindly scanned the 

| Computer One Pascal manual to go with 

/ the package available on my web site 

| (Computer One Pascal has kindly been 

| made freely distributable for the QL). 

| | Derek's work is a zipped searchable PDF 
file. It needs a recent version of Adobe 

REFORMAT reader to load the file - some versions such as 


Marcel Kilgus 


Dilwyn Jones writes: the version 6.0 installed on my computer give an 
‘| have added a new Reformat program to the — error on loading, but seem to display it OK). It is 
files page on my QL software download site. approximately 1.8MB in size, so think carefully 


Reformat is a rapid reformatter for floppy disks before downloading as it may take 10 minutes or 
(DD, HD, or ED) already in QL format. It is useful more on dialup. 

for bulk erasing of disks, for example. The pro- — www.dilwyn.uk6.net/language/index.htm| 

gram Is based on the non-pointered QFormat pro- 

gram by Norman Dunbar (with his permission), but + QDT Online 

this program is called Reformat, needs Toolkit 2, Jim Hunkins writes: 

direct sector access (works on most disk in- + have taken my QDT updates web page on line. 
terfaces) pointer environment and Window Ma- you can now download the demo and updates. 
nager 2. The program uses System Palette CO-  http-//jdh-stech.com/QDT/downloads.htm| 

lours. It is usable with recent versions of SMSQ/E. The current release is 1.02r._ If you have 1.01r al 
or with QDOS if you have pointer environment — ready installed, this downloaded update will work 
version 2 or later. for you 
www.dilwyn.uk6.net/files/index.html if you have an older version, please request a full 
And on the Launchpad download page you can install version from either your distributer or 
find a minor revision of the PicView graphics send an email with the info as described at: 
viewer accessory program, with a small bug fix http-//jdh-stech.com/QDT/qdt.htmi#Updates 


In the resize routine and a small change to the please use the link at that location for the email 
Quit routine - if the program was started with a request 


filename command parameter (e.g. from File Info 


Il) it no longer queries ESC to quit. 
www.dilwyn.uk6.net/gen/launchpad/ launchpad.html ZeXcel Patch 
Phoebus Dokos writes: 


. . 've completed a smallish (very ugly but works) 
TIDY-UP Version 2 now available patch (needs TK2 and Turbo Toolkit) for ZeXcel 
Dilwyn Jones writes: 0.33 with which you can replace the executable 
Some time ago, at Jochen’s suggestion, | wrote a contained ROMs with other ones 
program called TidyUp to assist with mundane . 


Currently tried and working ones: 

Gosh Wonderful v.0.3 (non single keyword entry, 
numerous bug fixes - type REM and ENTER for 
the extra commands) - 48K or 128K (Replace 
only 48K portion) 

SDOS 64+ (64 column ROM with bugfixes) - 48K 
only 

Pentagon (TRDOS not working) - 128K only 


Tried but NOT working: 

Plus 2 ROM (Although it is mentioned as a ZX 
Spectrum +2 compatible emulator ZexXcel 
actually emulates the 128K -See the ROM which 
states Sinclair Research instead of Amstrad for a 
“clue’). It will start properly, however it has trouble 
switching to the 48K model. My guess is that 
there's some patching of the ROM involved. 

SE Basic ROM - It actually loads in both 48K and 
128K mode but the tokenizer reappears where it 
shouldn't. 


For prepatched executables and the patch itself 
drop me a line. 

The patch may be downloaded from 
www.dilwyn.uk6.net/spectrum/index.himl 

Phoebus R. Dokos ql.css@dokos-gr.net 


Congratulations 

QL-Today congratulates John and Sarah Gilpin, 
treasurer and secretary of Quanta respectively, 
on their Ruby Wedding Anniversary (40 years) 
this month. 


QUANTA 


Members of Quanta will have noted a much 
improved print quality in the Quanta Magazine 
arising from changes in the production process. 
These changes have been introduced as the first 
step to producing the magazine in a downloada- 
ble form for those members who prefer to 
receive it in this way. 

The magazine is now produced in two resolu- 
tions. The version sent to the printer is of higher 
resolution than previously and there is also a low 
resolution version for downloading. So far down- 
loading is restricted to committee members and 
a handful of testers. The first of the download 
issues had a file size of 907 Kb and the second 
1.64 Mb. (The sizes of the files sent to the printer 
were 28.7 MB and 7.2 Mb respectively) 

The download experiment has shown there are 
two technical problems to be overcome. Firstly 
the quality of the graphics Is too low. In particular 
some of the advertisements are practically un- 
readable in the download version, probably 


because they have been scanned and not 
imported from the original images. Secondly the 
most user friendly way of printing out the 
downloaded image requires a file size too large 
for downloading on a non-broadband system. 


Your Top Ten 
What are the 10 QL programs you most fre- 
quently use? John Gilpin would like this informa- 
tion to assist him in compiling a list of the most 
popular QL software. He then hopes to run a re- 
gular feature giving the latest version of each of 
the programs in the Quanta Magazine. 

You can contact John Gilpin by email at 
treasurer@quanta.org.uk Or by snailmail at 181 
Urmston Lane, Stetford, Manchester M32 9EH, 
United Kingdom. 

John would still ike to hear from you even if you 
are not a Quanta member. 


SINCLAIRQL.INFO Website 


Javier Guerra has set up a new English language 
QL news web site: 
sinclairal.info 


Structured SuperBASIC 

Tim Swenson has now released Structured 

SuperBasic 2.7. He writes: 

“After much procrastination, I've finally finished 

and released Structured SuperBasic (SSB) 2.7. 

Biggest changes are: 

- Now compiled with Turbo. 

- Now supports three languages (English, Ger- 
man, Italian). Support for other languages is 
fairly trivial once | have the text translated. 

- Includes documents on how to use SSB with 
Make, RCS, & MicroEmacs. 

It can be found on my geocities site: 

www.geocities.com/svenghj/ 


SUDOKU 

George Gwilt's sudoku solving programs can 
now be downloaded from the SQLUG website: 
www.jms1.supanet.com 

To run the programs you will have to have an 
SMSQ system capable of running GD2 colours 
on high resolution screens. In addition to the tra- 
ditional 3 x 3 grid, George has written a program 
for 4 x 4 grids. The zip file includes the source 
code for each of the programs. 

George hopes to demonstrate both programs at 
the Manchester show. 


STOP PRESS NEWS: 


More Psion Changes 

Shortly before we went to press, QL-Today re- 
ceived a demo cisk of Roger Godley's updates 
of the Psion programs. This includes GD2 colour, 
high resolution screen versions of Abacus and 
Archive. We shall include a full news report in our 
next issue. 

Roger Godley hopes to attend the Hove show. 


Editor's comment: 

It is good to see that XChange is modified now, 
so that it can be used on modern systems and 
also uses some of the features like high-res or 
more colours. But is it to the benefit of the users 
that two authors produce two differently 
patched versions? Competition leads to pro- 
gress as we can see, but on the other hand it 
may be a waste of resources. What do YOU 
think? Tell us for an XChange special next issue. 


We apologise for a few errors that appeared in 
the last issue of QL Today. 


SUDOKU 

Our readers discovered that a % was missing 
after the third grid in line 1330. 

The last line of lan Pine's sample sudoku input file 
on page 27 disappeared during the production 
process. This should read 

010407030 

Some readers without a text editor asked how 
they could produce their own input file They 
could use a few lines of SuperBasic: 

90 OPEN_NEW #4, rami_sudoku_dat 

100 PRINT #4, "460300509" 

110 PRINT #4, "000000000" 

120 PRINT #4, "000709010" 

130 PRINT #4, "290008000" 

140 PRINT #4, "700605003" 

150 PRINT #4, "000200095" 

160 PRINT #4, "000000000" 

170 PRINT #4, "000000000" 

180 PRINT #4, "304007081" 

190 CLOSE #4 


MODE32BMP 

There was a fault in the program mode32bmp, 
which is in the folder gd2conv on the QL Docu- 
mentation Insider CD. The fault also appeared in 
the original article in QL Today, Vol 8 Issue 4, 
page 43. 

Dilwyn Jones writes: 

"Unfortunately we noticed a bug in one of the 
programs on the cover CD, a basic program used 
to convert QL screens/pic files to Windows .BMP 
graphics files. Although it was too late to change 
the CD, only a minor correction is needed in a 
program called mode32bmp_bas, located in the 
directory GD2CONV_GD2toBMP_. : 

270 GET #3, tmp% : ql_bp1 = tmp% : REMark bytes 
per line in QL file 

This forces the GET command to fetch a 2 byte 


integer instead of wrongly trying to fetch a 6 
byte floating point value from a QL _PIC file.” 

On the QL-users email list, Duncan Neithercut 
suggested changes to the program to convert 
mode 33 files (Q40/Q60) to bmp: 

1900 DEFine PROCedure Q40colours 

1905 FOR X = 0 TO pw%-1 


1910 blue = (PEEK(qlad+1)&&62) DIV 2 

1920 red = (4*(PEEK(qlad)&&7) ) | | 
((PEEK(qlad+1)&&192) DIV 64) 

1930 green = ((PEEK(qlad)&&248) DIV 8) 

1940 intensity = (PEEK(qlad+1)&&1) : 
REMark 0 or 1 

1950 POKE pead, (8*(blue) )+intensity*7 

1960  POKE pead+1, (8*(green) )+ 
intensity*7 

1970 POKE pead+2, (8*(red) )+intensity*7 

1972 qlad = qlad +e 

1975 pcead = pead +3 


1978 END FOR X 
1980 END DEFine Q40colours 


ANAGRAMS 

Stephen Poole writes: 

“Today | just happened to read one of the long 
english words used in the anagrams program, in 
a book on linguistics. Alas | had mis-spelt it. (| had 
held it in memory from school some 45 years 
ago and hardly used it since... It should have 
read: floccinaucinihilipiification, which is much 
harder to pronounce than my incorrect version of 
the word. The meaning is to qualify something as 
trivial. So | checked it out on the web, and came 
across an even longer monstrosity of a word, 
(even though the german language probably 
allows much longer constructions): 
oneumonoultramicroscopicsilicovolcanoconiosis, 
which has the advantage of being relatively pro- 
nouncable and at the same time is THE iongest 
word in the English language. 

Perhaps Dilwyn will send us the exact spelling of 
the welsh word known as ‘Llanfair P G” 


Sudoku musings only, no program listing this time. 
Do you do Sudoku too? So do |. That's what I've 
been trying to get my QL to do. I've been 
working with a collection of 41 puzzles, collected 
from the local newspapers. lan Pine’s program 
solves all of them, taking from 1 to 6224 
seconds, and does 25 of them in less than 2 
minutes. My program solves 33 of them in 5 to 
66 seconds and is stymmied by the other 8 of 
them after a minute or so. 


There are many interesting web sites with hints, 
methods, etc to help humans solve Sudoku so I'l 
keep at it. Wayne Gould(t) provides Pappocom 
puzzles and offers ‘how to do it’ suggestions. 


Wikipedia(2) has links to a glossary of terms and 
jargon and mentions something called ‘Dancing 
Links’ as the best computer algorithm. It uses 
729 rows and 324 columns in a Boolean array. 
Perhaps | can teach it to my QL? 


Wikipedia also has a section on the mathematics 
of Sudoku and some of my mathematical friends 
have wandered off into group theory to enume- 
rate the possible 9x9 grids. Let me count the 
ways? One figure given for valid Sudoku 9x9 
puzzles was 5,472,730,538. 


| noticed that there were 8 simple equivalent 
symmetries, 4 mirror and 4 rotation. Some would 
solve faster that others in lan’s program (eg. 5 
done in less than 2 minutes, the other 3 much 
longer), but not in mine. interesting? 


We can also shuffle the stacks, bands, columns 
within stacks, rows within bands, each with 6 
permutations. We could also make simple substi- 
tutions of the 9 digits in 9! or 362880 ways. 
Combining reflection, rotation, permutation, and 
substitution could iead to some 3762339840 
variations of the same puzzle, and some of those 
variations could be easier to solve. So how many 
puzzles, what makes them easier and how to 
index them? How would we recognize a puzzle 
as simply a variant of one we had dealt with 
before? 


Another interesting site is the Daily Sudoku(3) 
with several variations. | wrote a little basic pro- 
gram to convert their ‘classic’ PDF file to a plain 
text file as uSed in lan Pine’s program. So my col 
lection of puzzles grows. 


And still unresolved, how to use my QL to create 
unique puzzles. Hirofumi Fujiwara(4} shows how to 
do it by hand, with reverence for beauty and 
symmetry, 


I'd like to have my QL do something as nice as 
"Simple Sudoku’ by Angus Johnson(5). | recom- 
mend you have a look at if, great graphics 
content. 


| hope to return to the Lame curves, but for now, 
more time is being expended on the logic(?) of 
solving Sudoku with my QL. So please tell us 
what you've found, done, etc. with your QL? 


Websites of interest: 

(1) Sudoku.com 

(2) Wikipedia.org/wiki/Sudoku 

(3) www.dailysudoku.co.uk 

(4) www.pro.or.jp/7 fuji/sudoku/index-eng.html 
(5) www.angusj.com/sudoku 


Editor’s comment: 

fan Pine’s Sudoku solving program was appre- 
ciated by many readers, including Arnold 
Clarke, who has discovered one puzzle the pro- 
gram cannot solve: 

100006490 

000010006 

000000050 

000030005 

075020000 

008000009 

300501040 

200900000 

810000530 


Kaiser-Wilh.-Str. 302 D-474169 Duisburg 
Tel. 0203 502011 Fax 0203 502012 
http://smsq.j-m-s.com smsq@j-m-s.com 


SMSQ/E 


QPC2 Version 3 with SMSQIE ... now only EUR 59,90 
QPC2 Version 3 upgrade from Version 2... only EUR 19,90 
QPC2 Version 3 upgrade from Version1... only EUR 39,90 
QPCPrint ... still only EUR 39,90 


Please note that QPCPrint will be shipped on QD only. 

QPC2 will also be shipped on CD by default now, as more and more systems 
(especially notebooks) do not have floppy disks drives built in anymore. If 
you prefer QPC2 on HD floppy disks, please state with your order. 

Free updates are available on Marcel’s Website www.KILGUS.net 

If you prefer updates on CD or floppy disk, send in your master medium 
together with 4 international reply coupons to cover return postage, medium 
and packaging. 


SMSQI/E for ATARI or GoldCard or SuperGoldCard or QXL... 
now only EUR 39,90 


Colour drivers now included as standard for (Super)GoldCard versions 


For shipping inside Europe, EUR 3; will be added for postage and packaging. 
For shipping outside Europe, EUR 6, will be added for p & p. 


If you wish to place your order via internet, please do not send your credit card details in an email! 
Please use the secure contact form on the SMSQ homepage: SMSQ.J-M-S.COM 
We accept VISA, MasterCard and Diners Club! 


The BOOT is on the other Disk 
The standard method for many people when 
they wanted to start a program in the original QL 
system was to place the disk in mdvi_ or mdv2_ 
and reboot. This was fine while there was only 
{28Kb of memory available and even OK when 
the available memory increased to 512Kb with 
ExpanderRam or similar expansion devices but 
today's users have large amounts of memory 
available to them and, more to the point, have 
access to hard disk drives with enough storage 
Capacity to nave all the QL programs ever 
written available at their fingertips. 

Not only that but we now have extended reso- 
lutions, high colour drivers and subdirectories all 
of which were pipe dreams when the QL was 
first on the market. They are now all there all you 
have to do is reach out for them and the aim of 
this series is to help those who may feel a little 
left behind by QL development to get up to date. 
It is also a chance for some people to learn, or 
re-learn, some skills and to get a more efficient 
system. We have, so far discussed the various 
aspects of the hardware we will have to deal 
with and, in last issue's section, we touched upon 
some of the basic software. 

It is at this point that a boot file becomes an 
essential thing and too many people start off 
with the conviction that they cannot write one. 


Don’t Worry. 

Anyone can write a boot file. If you can write 
down the directions to get to your house you 
can write a boot file because that is what a 
BOOT file is. It is a list of directions to tell the 
computer where things are and how to get to 
them. | would like, in this section, to tell you how 
to do it because without it many of the QL's 
capabilites will always be beyond your reach. 

To start with there is no ‘correct’ way to write It. 
You can buy the most expensive editor available 
or you can use the one that comes free with all 
QDOS systems (the command line) - the choice 
is up to you. Almost every person that you meet 
will look at your boot file and say, ‘Ah but you 
should......... and my advice is to listen to them 
and then make up your own mind. | have learned 
a lot of useful tins from other people and | have 
hee a lot of rubbish at the same time. 


No boot file is static. It changes as your system 
and your knowledge changes and that is the key 
to it. If it works it is a good boot file and if it does 
not do what you want then you can change it. 
You are in command. 


What does a boot file do? 

If you imagine that your system is a house then 
the boot file is the key that allows you to open 
the door and let yourself in. Not only that but it 
can also allow you to decorate and set up some 
of the furniture you may need. The programs and 
data are all rooms within that house and they all 
have specific functions. 

When you buy a new piece of software it has its 
own boot file on the master disk and that is the key 
to that particular room but when you have a hard 
disk you can start building a skeleton key which will 
let you into any of the rooms on that disk. 

There are certain things that a boot file does. 


1. Opening Screens and Windows 

Many programs put a ‘splash screen’ up as they 
open and these can contain logos and informa- 
tion about the program which is being run. There 
are specific commands in BASIC to load and 
display these screens. 
If you are running SMSQ/E on an Aurora / Atari / 
QXL / Q40 / Q60 / QPC2 or other system with 
increased screen resolution you may find that the 
opening screen is just a small box compared with 
the full three coloured screens displayed on a 
standard QL. We discussed WINDOW commands 
in an earlier section of this series. Writing 
‘WINDOW’ commands into the boot file will allow 
you to open the screens to the full size available 
on your monitor Other commands are available 
to reduce or enlarge the screen resolution so 
you can make the text more legible or make 
things display in the way you want. 


2. Setting Defaults 

Some programs need to have specific default 
settings. The most common of these are: 
PROG_USE - the program default. 

DATA_USE - the data default. 

DEST_USE - the destination default. 


These will be discussed in more detail later 


3. Loading Resident Procedures 

Many programs require resident procedures or 
extensions to be present before they will run. All 
Pointer Environment programs, for instance, need 
the three extensions WMAN, PTR GEN and 
HOT_REXT and many other programs need simi- 
ar extensions to run. The BOOT file provided on 
the master disks for these programs will do the 
oading for you but, when you have to write a 
master BOOT file for a hard disk system, you will 
have to list which programs are to be loaded and 
then make sure that the appropriate extensions 
are present. 

One essential thing to realise here is that 
SMSQ/E has the three Pointer Environment files 
and the Toolkit Il extensions built into it. If you 
load the three PE. files after loading SMSQ/E you 
will probably be loading older and less compati- 
ble versions of the files which are already in 
existence in memory, 


4. Setting Environment Variables 

Environment variables are used by some pro- 
grammers instead of Configuration Blocks. They 
have become increasingly popular recently and 
need to be set up before the programs they refer 
to are called. 


5, Setting HOTKEYS and strings 

You can use your BOOT file to set up various 
HOTKEYS which can be called at any point to 
perform set actions. The Pointer Environment al- 
lows the setting of HOTKEYS for calling pro- 
grams or issuing a command to the ‘command 
line interpreter’ in BASIC. One thing to be remem- 
bered here is that the BASIC window must be 
available to do this. If BASIC is put to sleep then 
all you will get is a short ‘BEEP’ and no action. 
One other useful thing to be set in the BOOT file 
is a string which can be called from a HOTKEY 
Things like the current date can be set up and 
used in any program. 


6. Running Programs 

Finally, you can run programs from the BOOT file 
either directly or from simple HOTKEYS. This is 
where management systems such as TASK- 
MASTER and QPAC Il come in. In my discussion 
of this | will only refer to QPAC II since TASK- 
MASTER is no longer available commercially. 

All of the above points will be discussed in more 
detail in later sections but, before | launch into this 
| would like to say a few words about directory 
Structure. 


Sub-Directories 
When you move from a floppy disk based sys- 
tem to a hard disk based system you immediately 


have a lot more space to play with. This can 
cause you a lot of problems if you cdo not give 
the matter some thought right from the start. On 
a disk you can only have a small number of files 
so it does not matter too much if they ail exist in 
the root directory, It is fairly easy to page through 
them and find the one that you want. Once you 
move to a hard disk system the number of files 
you can store increases dramatically and it is 
very easy to lose files in the general chaos. This 
is where a sub-directory structure comes in very 
handy. 

There is no set way to structure your files. You 
do have two definite possible dividing points in 
the form of DATA and PROGRAMS so setting up 
a subdirectory for each of these would be a 
good idea. You could also set up an extensions 
subdirectory so that you can store all of the 
resident extensions in one place. This makes 
sense when you have to update files because 
you know immediately where to find them. On my 
hard disks (| have three main systems and try to 
have the same siructure on each of them) | di- 
vide DATA and PROGrams and then have smaller 
sub-directories within them to provide further 
compartments. In the PROG subdirectory for in- 
stance | divide the programs between full pro- 
grams such as QD / QSPREAD / etc and utility 
programs such as CALCULATOR / CALENDAR 
etc. The DATA subdirectory is divided into DATA 
subjects like clip art, the Q Branch DATA, 
Quanta/QL Today articles etc. 

There are also some programs which have their 
own subdirectories. Text 87, for instance, has a 
large number of fonts and anciliary programs. 
These are all stored in a directory of their own. 
ProWessS has a setup program of its own which 
automatically creates subdirectories and stores 
the files directly there so the ProWesS programs 
all have their own compartments on the hard 
disk. 
| keep all the programs that | am writing in a sub- 
directory called (imaginatively) 'MYPROGS’. This 
is, again, a handy way to keep all of the code in 
one place for easy access. 

One final slot on the disk is a TEMP directory. | 
find this invaluable to store files that you are 
either working on or keeping for a short time. 
Keeping them in a temporary subdirectory is a 
good way to avoid losing them in other direc- 
tories and you can make it a habit to periodically 
flush out the TEMP directory to regain hard disk 
space. 

Different systems store the hard disk information 
in different ways. If you are using a QXL or QPC 
system the files which appear to the system as 
WINi_ are seen by the host system as a single 
file called ‘C://QXLWIN. QPC and the QXL can 


have up to eight QXLWIN files with names which 
can be configured from the program's config 
block. The QXL used to be able to only see one 
file on the root hard disk as a QXLWIN file but, 
with later versions of SMSQ/E for the QXL it is 
able to have the same flexibility as QPC 2. The 
old rule, which is stil true for SMSQ and early 
versions of SMSQ/E for the QXL is: 

C\QXLWIN = WIN. 

D:A\QXLWIN = WIN2_. 

and so on. It is possible to use the DOS com- 
mand SUBST to create extra ‘virtual’ hard disks 
and each of these can hold a QXLWIN file. This 
method is memory intensive but does work well 
on DOS v6 and above. 

Qubide users have a different system because 
the driver is completely different. You can create 
eight ‘WIN’ files on a single hard disk and link 
these in and out by using the WIN_DRIVE com- 
mand. This is a very useful command because 
each 120Mb partition that is linked in will take 
around 100Kb of your system memory for its 
map. It is, therefore, a good idea to organise the 
data stored on these disks to the best advan- 
tage. WINL_ must exist and is linked in on boot up 
so this is the best place to store all of the pro- 
grams and the data which is in most common 
use. Other locations such as WIN2_ can be used 
for clip art and only linked in when they are nee- 
ded. Until version 2.xx of the Qubide ROM you 
could not make a subdirectory if files containing 
the same name were already in existence. This 
means that if you have files called: 
WINL_TEST_first_bas 

WINI_TEST_second_bas 

etc. you could not use the MAKE_DIR command 
to make WINI_TEST_ as a new subdirectory. 
The hard disk drivers of the QXL and QPC could 
always do this and would then store the files in 
the new directory. With Qubide you had to re- 
name or move the files to another place and 
then create the directory and move then into it. 
The later version {v2.00 onwards) of Qubide 
allows you to create directories in the same way 
as the QXL and QPC drivers do. 

To create a new directory such as the one above 
go to the command line and type 

MAKE_DIR WIN1_TEST_ 

this will create a subdirectory on wini_called 
‘TEST. to read the directory type 

DIR WIN1_TEST_ 


Full information on the Qubide directory structure 
and the use of Qubide commands can be found 
in the instruction manual. Information on the QXL 
and QPC directory structure and commands 
which relate to them are found in the Manual 


which accompanies the QXL and Super Gold 
Cards. 

A good sub-directory structure is essential to 
maintaining a system and you should give the 
matter a lot of thought before committing your- 
self to it. 


1. Getting Started and Choosing an 
Editor 

So now we are about to start to write our BOOT 
file how exactly do we go about getting it all 
Started and, more importantly, which editor do we 
choose to do it in ? 

QDOS systems provide the user with a free built 
in editor and this one even has built in error 
checking so you can actually launch straight in 
using this. Assuming that you are using SMSQ/E 
or have activated the Toolkit il extensions by 
typing the command 

TK2_EXT 

at the command line you can launch the editor by 
typing 

NEW 

to clear any program lines that may be lurking in 
memory and then 

ED 

You are then presented with a flashing cursor in 
Window #2. Type in a line number (try 100) and 
Start from there. 

lf you lean towards a more featured editor you 
could try using some of the other editors that are 
available. There are several editors that can be 
used to produce passable BOOT files and, if you 
ask different users you will get different answers 
as to which ones people prefer Free editors 
include QED and MicroEmacs - the former sup- 
plied by some POD libraries as a reader for their 
files and the latter recompiled and made P E. 
compliant by Theirry Godefroy. MicroEmacs is the 
best featured of these two with many commands 
available for formatting and re-structuring text 
files and is probably a bit overpowering for the 
Casual or novice user. 

Many people swear by (or at) the Editor This was 
Digital Precision's flagship editor and again it 
certainly has a large array of features, many of 
which are again not applicable to writing BASIC 
programs. 
My own preference is Jochen Merz’s QD. This Is 
a pointer driven editor with a lot of features but 
most of these are tailored towards the program- 
mer. It does allow you to write the code first and 
number/re-number the lines later It also has a built 
in Hyper Helo system which will pop up defini 
tions and syntax explanations for many BASIC 
keywords and is a great help. 

In the end it all comes down to personal prefe- 


rence so have a look at as many editors as you 
can and then make a choice based on what you 
actually want. For the purposes of this article all 
of the BOOT files that we are going to create 
can be writien using the QDOS ‘ED’ editor so 
don't rush out to buy a new program - it wil only 
be something else you will have to learn about 
and may get in the way of learning the process 
of writing the BOOT file. 


Il. Opening Screens And Windows 

Most of us are used to the familiar three window 
setup of the QDOS Screen unless, of course, you 
have opted to start in TV mode. Once you fire up 
a QL system you are presented with a choice of 
pressing Fi or F2 (| will leave the Minerva options 
to one side and concentrate on the two QL 
options because they are not relevant to this 
discussion}. | have, in a previous section of this 
series spent a bit of time discussing the window- 
ing on a Standard QL in order to fill in a few gaps 
or refresh your knowledge. Iwill, quickly, go over 
that ground again. 


A Bit of History 

The original QL was supplied with two options at 
Startup so that users with monitors could take 
advantage of the wider screens available for 
these devices and get an 80 column display 
instead of the 40 columns available in TV mode. 
At the time this was an innovation because most 
of the home machines available then would only 
plug into a TV set. Pressing F2 opened only two 
windows #0 and #1 and gave a screen size of 
256 x 256 pixels, Channel! #0 is the console win- 
dow which accepts commands and Is displayed 
at the bottom of the screen with white ‘INK’ on 
black ‘PAPER’. It is also used by some programs 
to display information while the program is 
loading. This information is usually the name of 
the program, version number and author / copy- 
right message. Channel #1 is the default output 
channel and appears in the centre of the screen 
with white ‘INK’ on red ‘PAPER’. Typing 

PRINT "Hello" 

at the command line will result in the word "Hello" 
appearing in the red window. If you change the 
ine to 

PRINT#O, "Hello" 

the same word appears in the black window 
beneath. 

f, however, you press Fi on startup the screen is 
very different. It is now divided into three win- 
dows one white, one red and one black. These 
three screens are given numbers and, as such, 
are labelled channel#0, channel#1, and chan- 
nel#2. #0 is the console channel and it is that 


channel that accepts the SuperBasic commands 
and displays messages in the same way as 
when F2 is pressed. Again it has black ‘PAPER’ 
but this time the ‘INK’ is green. Channel#t is, 
illogically, on the right hand side of the screen 
and this is displayed with white INK’ on red 
‘PAPER’. If you have a disk in any of the drives 
and you call up a directory the list of files will 
appear in this window. This is the default display 
channel so typing 

PRINT "Hello" 

will cause the word “Hello” to appear there. 
Channel #2 is on the left hand side of the screen 
and has white ‘PAPER’ with red ‘INK’. These two 
screens are rather confusingly labelled in reverse 
in the QL User Guide but you can test this out 
for yourself by typing in the lines above. If you 
have a Gold or Super Gold Card and you have 
installed Toolkit 2 (by typing ‘TK2_ext’) on the 
command line you can load a basic program and, 
then typing 

ED 

on the command line will list the program in 
channel#2. 

The above concepts are very important when 
you move up to one of the more advanced sys- 
tems. One mistake made by some programmers 
on moving from a standard QL to one of the ad- 
vanced ones is to neglect the opening of win- 
dows in their own programs. Because the F2 
screen has channels #0 and #1 opened and 
defined for you many people who started In this 
mode find that their own programs are displayed 
incorrectly on the new systems. 

This problem also applies to some of the earlier 
commercial programs written in the QL’s infancy, 
even some written to operate in monitor mode 
and for this reason the first screen opened by all 
current QL systems is the standard 512 x 256 
oixel Fi screen as a compromise. It does not cor- 
rect programs written for the F2 startup but it 
does help some of those which write directly to 
the 512 x 256 screen. At this point the next pitfall 
comes up. The original QL screen was at a spe- 
cific address in memory so programmers could 
write directly to that address to display their 
screens. When the Gold and Super Gold Cards 
came along they had to patch the QL’s memory 
onto their own boards and some clever program- 
ming was needed to make these programs work. 
The whole thing became impossible when the 
QXL, QPC and Aurora arrived so some of these 
programs will not display properly, 

That, therefore is a good place to break this 
article until the next issue. In the next part we will 
Start to build a BOOT file in earnest. Flex you 
typing muscles! 


Introduction 

| always like lectures to be illustrated. When the 
speaker's voice recedes into the background of 
my thoughts | find myself looking more carefully 
at the screen containing the latest piece of infor- 
mation deemed relevant. | will take note of its 
colour and check for any misspellings. Reluc- 
tantly | might even read and try and understand 
what is presented - which peculiar behaviour 
might lead me back to the words issuing from 
the speaker's mouth. You might deduce from this 
that | judge lectures without some distraction to 
be in danger of exhibiting an unwelcome degree 
of aridity, 

In recent times all the talks | have attended have 
taken the same format. A lecturer stands, or sits, 
beside a laptop computer and fiddles with its 
keys from time to time while he delivers his 
diatribe and, lo and behold, from time to time 
different images appear on the large screen set 
at the front of the hall. 
When | agreed to say something about Turbo at 
a recent meeting in Portsmouth | immediately 
purchased a laptop computer installed the se- 
cond most recent version of QPC2 (the most 
recent version of anything is likely to contain 
some errors, [though to be fair one would not 
expect that of Marcel Kilgus]), and set about 
preparing the illustrations designed to alleviate 
the boredom of the audience. 


General Idea 

What | decided to do was to arrange a set of 
images which would be sent from the laptop to a 
projector | would scan through the images by 
pressing the up and down arrow keys. Since | 
wanted to be able to intersperse the images with 
the running of actual programs, some S*BASIC 
and some compiled executables, | realised that it 
would be easiest if the image-showing program 
were executable too and not run in S*BASIC. 

| thus decided to write the program for image 
projection in S*BASIC and compile it (with Turbo 
of course}. | would call the program “slides” since 
in the old days the projector would be fed with 
“slides” which are transparencies taken by a 
camera. My mother used to call the projection 
apparatus a ‘magic lantern’. 


Images 
The images to be relayed to the projector were 


taken from the computer's screen and stored as 
"partial save areas’ as defined in the official docu- 
mentation for the Pointer Environment in the 
QPTR manual. The images were expanded to a 
size to fit the area on the projector's screen by 
the program ‘pr2win”. | stored all the required ima- 
ges in a directory on the hard disk. 

NOTE The program "pr2win’ is available as part 
of “svscr.” from the SQLUG website: 
www.jms1.supanet.com 


Hot Keys 

My talk required me to load some S*BASIC pro- 
grams, to run these, to compile them and even- 
tually to run the result. Experience told me that 
my typing skill would result in several, if not the 
majority, of the commands to be sent being faulty, 
To save time and embarrassment | decided to 
use the Hot Key system to cut down the number 
of key presses needed. The following five lines 
of a StBASIC program show what | used: 


2310 ERT HOT_PICK('t', 'slides') 

2320 ERT HOT_PICK('p', 'pe_demo') 

2330 ERT HOT_CMD('h','ex ram1_demo3_task' ) 
2340 ERT HOT_CMD('i','ex ram1_test_task') 
2350 ERT HOT_CMD('j','load demo3') 


For example, | wanted to load my version of 
QPTR's demo_bas. | just pressed ALT/| to 
achieve this. In the midst of discussing my altera- 
tions to this program (so that it could be compiled 
by Turbo) | wanted to return to the slides”, Pres- 
sing ALT/t did this. 

After compiling demo3_bas | was able to run the 
result by pressing ALT/h. That having been done | 
was able to return to the compiled demo3 by 
pressing ALT/p. 

The command ALT/i enabled me to run the com- 
pilation of a program which had been loaded be- 
fore | began the talk. 


The Program “slides” 
The source code for ‘slides’ is given below and 
explained now. 


The TURBO.. commands in lines 110 to 210 
These commands obviate the need to set vari- 
ous conditions in the front panel which appears 
when Turbo is called by CHARGE. 


_windo 0 
None of the windows #0 to #2 is used 
optim "Brief" 
A small program is requested and not a longer 
faster one 
_mode "64" 
Small branches will fit 
_struct "Struc" 
Main program lines precede procedures and 
functions 
_diags "i" 
Line numbers are included to help debugging 
_taskn "slides" 
This is the Job Name for the compiled program 
_repfil "rami_err" 
The listing is sent to a file and not the screen 
_objdat 2 
A 2K dataspace is enough 
_objfil "rami_slides" 
This is the compiled program's name 
_buffersz 200 
Ensures that Parser_task produces inter-code 
all in ram 
_objstk 350 
Sets the stack size of the compiled program to 
350 (normal) 


Setup 

1. Two windows are opened, the first, #3, is for 

the main part of the screen. The second, #4, 

is for a title, which will remain throughout. To 

accommodate differing sizes of screen, the 

windows are set using SCR_XLIM and 

SCR_YLIM. In general programs destined for 

QLs with other operating systems than 

SMSQE | would use the TurboPTR function 

W_MAX which returns the x and y sizes in a 

long word. In the present program there was 

no need for this since | knew that | was 

operating under SMSQE. 

nw’% is set to the number of slides less 1. 

ot% is set to point to the first slide. 

The array fnS is set to the nw%+1 slide 

names. 

5. Finally the title is set in #4 by the procedure 
Ptf and the first slide set, also by Ptt. 


Fwh 


Ptf 

The procedure Ptf sets the image a$ in the 
centre of the window at #3, or #4, depending on 
the value of the parameter o% (0 for #4, the title 
window, and 1 for #3, the main slide window). 

As already explained each image |s in the official 
partial save area (psa) format. This means that 
each image can be placed anywhere in a window, 
(providing there is space for it!) by the official Trap 


#3 PE software, IOP RSPW. TurboPTR contains 
the procedure BRSPW using that routine. It is this 
orocedure, at line 2110, that is used to set the 
image in the middle of the window. 
The final parameter of BRSPW is 1. This prevent 
the saved area being returned to the heap. Th 
following instruction at 2115 returns the area to 
the heap. Why was that final parameter parame- 
ter not 0, which would have saved an instruction? 
The answer is that the area was claimed from 
the heap by ALCHP at line 2070 and not by the 
PE Trap®3 routine |OPSVPW. It is therefore neces- 
sary, for safety, to return the area by RECHP and 
not via IOPRSPW. 


Dm 


Do_lit 

The main part of the program is in the procedure 
Do_lt. This is remarkably simple. Only ESC and 
the up and down keys have any effect. ESC quits 
the program. The up and down keys print the 
previous or next image if there is one: if not, a 
BEEP command is issued via Noise. 


Finish 
.. does nothing. It was there just in case. 


DATA lines @ 4000 onwards 

The lines 4000 onwards list the images to be 
used. Each line gives the name of a file contining 
the psa information for the image to be loaded. 
Lines 4030 and 4050 each point to the same file. 
This is because | wanted to go back to an earlier 
image after showing the one whose addcress is 
at line 4040. | judged it better to repeat the 
image in the list rather than fiddle around pres- 
sing the up and down keys and going backwards 
and forwards. 


Examples of images 
To give an indication of what ‘slides’ showed two 
examples appear here: 
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Source Code for “slides” 


110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
1000 
1010 
1020 
1025 
1027 
1030 
1040 


1050 
1060 
1070 
1080 


1090 
1100 
1110 
1120 


1130 
1140 
1150 
2000 
2010 
2020 
2025 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 


2115 
2120 
2130 
2140 
2150 
2160 
2170 
2180 


TURBO_windo 0 
TURBO_optim 
TURBO_model 

TURBO_struct 
TURBO_diags 

TURBO_taskn 
TURBO_repfil 
TURBO_objdat 2 
TURBO_obj fil 
TURBO_buffersz 200 
TURBO_objstk 350 


"Brief":REMark Rem/Fast 
".64":REMark > 64 
"Struc":REMark Freef 
"i":REMark Omit/Include 
"slides" 

"rami_err" 


"rami slides" 


Setup: Do_It: Finish 


DEFine PROCedure Setup 

DIM wx%(1),wy%(1) 

up=$D0: down=$D8 : ESC=27 
wx%(0)=SCR_XLIM: wy%(0) =30 
wx%(1)=wx%(0) :wy%(1)=SCR_YLIM- 
wy%(0) 

OPEN#3, scr: OPEN#4, con 

WINDOW#3 , wx%(1),wy%(1) ,0, wy%(0) 
WINDOW#4, wx%(0),wy%(0),0,0 
nw%=16:REMark Number of items (-1) 
to show 

DIM fn$(nw%,40) 

RESTORE 4000 

FOR x=0 TO nw%:READ fn$(x) 
pt%=0:REMark points to 1st item to 
start with 

CLS#3: CLS#4 

Ptf "win2_talk_tok3_psa",0 

Ptf "win2_talk_sc7a_psa",1 
END DEFine 


DEFine PROCedure Ptf(a$, 0%) 

LOCal fln,asad,x2%,y2% 

REMark puts a$ in centre of window 
REMark 0%=0 for #4, 1 for #3 
CLS#4—0% 

fln=FLEN(\a$) 

asad=ALCHP(fln) 

LBYTES a$,asad 
x2%=PEEK_W(asad+6) 
y2%=PEEK_W(asad+8) 

BRSPW#4—-0%, asad,0,0,x2%,y2%, 
(wx%(0%)—-x2%) DIV 2, (wy%(0%)-y2) 
DEV 2,1 

RECHP asad 
END DEFine 


DEFine PROCedure Do_It 
LOCal 1lp,inp 
REPeat lp 
inp=CODE( INKEY$(#4,-1) ) 
SELect ON inp 


2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 
2380 
2390 
2400 
2410 
2520 
2990 
3030 
4000 
4010 
4020 
4030 
4040 
4050 
4060 
4070 
4080 
4090 
4100 
4110 
4120 
4130 
4140 
4160 
4170 


=up:Do_Up 
=down: Do_Down 
=ESC:EXIT 1p 
END SELect 
END REPeat lp 
END DEFine 


DEFine PROCedure Do_Up 
IF pt%=0:Noise:RETurn 
pt%=pt%-1 
Ptf fn$(pt%),1 

END DEFine 


DEFine PROCedure Do_Down 
IF pt%=nw%:Noise:RETurn 
ptZ=pt%+1 
Ptf fn$(pt%),1 

END DEFine 


DEFine PROCedure Noise 
BEEP 30000, 24,151,99,2,9 
END DEFine 


DEFine PROCedure Finish 
END DEFine 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


"win2_talk_sc7a_psa" 
"win2 talk sdd5a_psa" 
"win2 talk_sd6a_psa" 
“win2_talk_sd2a_psa" 
"wine2_talk_tik1b_psa" 
"wine _talk_sd2a_psa" 
"win2_talk_sd7a_psa" 
"win2_talk_sd9a_psa" 
"win2_talk_takli5a_psa" 
"win2_talk_takl6a_psa" 
“wine talk takl3a_psa" 
"win2_talk_sd9a_psa" 
"win2_ talk tykla_psa" 
"wine _talk_sd9a_psa" 
"win2_talk_sd8a_psa" 
"wine_talk_tak5_psa" 
"win2_talk_tak6_psa" 


At QL is 21 | made a proud boast. | was due to 
give a presentation on the new colours, and pro- 
mised that in half an hour | could teach almost 
any one present to program in the new colours 
using just eleven lines of SuperBasic and no 
pointer environment jargon. 

| heard a trader mutter under his breath, "They will 
be very long lines!” 


Well, you can judge for yourself because | am 
about to repeat the promise. Almost any QL- 
Today reader, who works through this tutorial, 
can learn how to program in the new colours 
using a SuperBasic program of just eleven lines. 
And there will be no pointer environment jargon. 
There iS no point in reading this article unless 
your machine is fired up and ready to go. And, of 
course, your machine must be able to handle the 
new colours. That means you have QPC2, a 
Q40/60, a QXL or an Aurora card using a version 
of SMSQ/E above 3.00. 


Can you remember the very early days of the 

QL, when we typed in green or white text on a 

black background and PC users in white text on 

a blue background? Some Quill users were dis- 

appointed they could not type in white text on a 

blue background. 

Today you can change the colours Quill uses 

using just one line of basic: 

PALETTE_QL 0,255,255,0,0, 16777216, 
16777216, 2607363, 2607363 

(Don't be frightened by these numbers. You will 

see why | am using them in a moment!) 


After typing in this line, press enter and if you 
don't see a cursor press ESc. 

Now start Quill. The colours are different, but it is 
not a pretty sight! Try running some other pro- 
grams and you will see you have also changed 
the colours in those. Don't they look horrible? | 
probably should have warned you to have a sick 
bag ready. 


There was a purpose in this little exercise. First of 
all it shows you how much power the new co- 
lours give you over your machine. But it also 
shows you what a mess you can make if you 
don't use the new colours wisely. And think how 
terrible programming would be if we continually 
had to enter numbers like those above. 


So let's reset the machine and pause for a little 
bit of history and a little bit of theory, But first a 
promise. When we learn how to program in the 
new colours in the proper way, there will be no 
numbers higher than 65535! 


The new colours first became available in 1999 
for the Q40, and a year later for QPC and the 
QXL. There was a much longer wait before they 
were introduced on the Aurora Card. 

For various technical reasons each QL platform 
had its own implementation of the new colours. 
For example, the Aurora card has only limited 
memory available and can only handle 256 
colours compared with thousands for the other 
platforms. 


Because each platform had its own colour 
implementation, in the early days you had to put 
a command in any SuperBasic program to tell it 
which colours to use. There were four 
commands: 


COLOUR_QL were the standard QL colours. 
However you could modify these using the 
PALETTE_QL command we used in our Quill 
demonstration. 


COLOUR_PAL was a palette of 256 colours. Again 
these could be modified by the user via the 
command PALETTE_8& 


COLOUR_24 were true colours or 24 bit colours. 
However no present QL platform can handle 24 
bit colours. You were also told to enter values in 
HEX. 


COLOUR_NATIVE were the colours that your QL 
platform used. 


lf you are finding this a little complicated you are 
in good company. Quite a few program develo- 
pers and traders also found it complicated. In 
particular it was difficult for them to write pro- 
grams that would look the same on all platforms. 
lt was no co-incidence that in the first few years 
we had the new colours scarcely any software 
was written using them. 


What the QL urgently needed was a much 
simpler way of using the new colours that was 


common to all platforms. That happened in 2003 
when Marcel Kilgus developed a new Window 
Manager able to display the new colours. 
"Window Manager?” Isn't that something to do 
with the dreaded Pointer Environment? 

Yes it is, and if you use the new colours you will 
be using part of the pointer environment. But 
don't panic. The pointer environment is already 
built into SMSQ/E and the good news is that you 
dont need to know anything about it to use the 
new colours. You can use them in a simple 
SuperBasic program, which is what we are now 
going to do. 


SO back to our machines. First of all we are going 
to be lazy and use the Toolkit 2 command to set 
our windows, and then we are going to use 
white ink on a black background: 

10 WIV 

20 INK 7: PAPER 0 : CLS 

Now we are going to modify Window #2 to give 
it a black background and a white border: 

30 WINDOW #2, 300,154,50,50 

40 PAPER #2, 0 : CLS #2 

50 BORDER #2,2,7 


Now an input command: 

60 AT 2,3 : INPUT "Colour: ";colour 
Now a block of colour: 

70 BLOCK #2, 292,50,0,0,colour 


We repeat this line twice with some slight 
modifications: 

80 BLOCK #2, 292,50,0,50,colour+5 

90 BLOCK #2, 292,50,0,100,colour+10 


Now add a pause commana: 
100 PAUSE 


And now for something really naughty: 
110 GO TO 60 


Let's just print that again in one piece. 
10 WTV 

20 INK 7: PAPER 0 : CLS 

30 WINDOW #2, 300,154,50,50 

40 PAPER #2, 0 : CLS #2 

50 BORDER #2,2,7 


60 AT 2,3 : INPUT "Colour: ";colour 


70 BLOCK #2, 292,50,0,0,colour 

80 BLOCK #2, 292,50,0,50,colour+5 
90 BLOCK #2, 292,50,0,100,colour+10 
100 PAUSE 

110 GOTO 60 


Now | count eleven lines, and not a long line in 
sight! 

Think of a number between 1 and 245, and make 
a note of it. Run the program, input that number 
and you should have something like figure 1. 


Now we are going to modify a part of this pro- 
gram to use the new colours. Break into the pro- 
gram (CTRL + SPACE) and put WM_ before each 
BLOCK keyword in lines 70 - 90. These lines 
should now appear as: 

70 WM_BLOCK #2, 292,50,0,0,colour 

80 WM_BLOCK #2, 292,50,0,50,colour+5 

90 WM_BLOCK #2, 292,50,0,100,colour+10 


WM means "Window Manager’ and the new 
keyword instructs the QL to use the new colours. 
Run the program input ting the number you used 
it looks just the same 
as it did using the old mee This is because it 
is meant to look the same. 

The Window Manager colours are not a single 
series of colours, but several groups of colours. 
The first group of 256 colours is exactly the 
same as the QL colours. 

Now add 256 to the number you have just used 
and input this number into the program. This time 
you will notice a difference as you are now using 
the new colours. The second group of colours 
from 256 to 511 are the 256 palette colours. 

We are going to skip over the 3rd group of 
colours as they cannot be illustrated by this pro- 
gram. These are the colours from 512 to 767 and 
it is better to avoid these altogether until you 
have gained confidence in using the other 
groups. These colours modify the appearance of 
most pointer environment programs. 
Now add 768 to the number you have noted 
down and enter this. The group of colours from 
768 to 1023 are various shades of grey. (Aurora 
users may have some difficulties with this part of 
the tutorial) 
Let us make a summary of the groups of colours 
SO far: 


0 - 255 QL colours 

256-511 Palette colours 

512-767 System colours (do not use!) 
768 - 1023 Grey shades 


Now something different. We have to break into 
our basic program again and amend line 50 so 
that it reads: 

50 WM_BORDER #2,2,1024 


Run the program and you will see the border has 
changed to give the window a slightly raised 
appearance. Break into the program again and 
change 1024 to 1025 and when you run it this 
time you will see the border gives the window a 
slightly sunken appearance. 

The group of colours 1024 to 1279 are the way in 
which programmers give their programs a 3D 
appearance. For obvious reasons you should 
only use these numbers with the WM_BORDER 
command. 
Please note the colours of the border are deter- 
mined by the colours your version of SMSQ/E 
uses to display the pointer environment. If you 
want to use your own colours, you have to in- 
struct the window manager to use those colours, 
set the 3D border and then instruct the window 
manager to revert to the old colours. This is sim- 
ple to do but beyond the scope of this article. 

| have not done a great amount of research on 
3D effects, but Wolfgang Uhlig, who has done far 
more, advises the use of the range 1024 to 1039 
only. 


We now move into the realm of the big numbers. 
Try running the program with numbers in the 
range 16384 to 32767. These are stippled co- 
lours. At one time | wondered why we needed 
stipples, but George Gwilt tells me that they are 
often more interesting to use as a background 
than solid blocks of colour 

The last group of colours are the RGB colours 
and they are in the range 32768 to 65535. Again 
you can experiment with several numbers in this 
range. Aurora card users should remember, how- 
ever, that although there are 16,383 stipples and 
32767 RGB colours they cannot display the 
majority of these. 

You now know how to use the new colours in 
your own programs without any knowledge of 
pointer environment programming. 

First the easy bit. To use the new colours all you 
have to do is change PAPER, INK, STRIPBLOCK 
and BORDER to WM_PAPER, WIM_INK, 
WM_STRIP WM_BLOCK and WM_BORDER re- 
spectively. When you do this, but don't change 
the values, the program will look just the same 
as before because the first 256 Window 
Manager colours are the same as the old QL 
ones. You can change the values of the colours 
at your leisure. 


WE ARE FREE! 


JUST WORDS! 


Now there’s a misleading headline! Sorry, but we are not giving everything away, 
although you must agree our prices are a bargain. No, now that we are free from Quanta 
duties we shall be returning to active trading at QL shows, including Eindhoven, 


Manchester and Hove. 


And, speaking of shows, we are still retaining our QL shows web page which we set up 


on behalf of Quanta: 


http://members.lycos. co.uk/geoffwicks/qlshow.htm 


Remember our highest price is only a tenner! 


JUST WORDS! CONGRATULATES QL-TOOAY ON ITS 10TH PUBLISHING YEAR, 
Geoff Wicks, 56 Peveril Crescent, West Hallam, Derbyshire DE7 6ND, U.K. 


Tel: +44 (0)115 - 930 3713 


email: gwicks@beeb.net 


Web: http://members.lycos.co.uk/geoffwicks/justwords.htm 


Now the difficult bit. How do you know which 
number to use for which colour? 

There are a number of tools to helo you. 

Firstly the 256 palette colours. In the SMSQ/E 
manual you will find a short program to display 
these colours. To save you looking it up it is re- 
produced with this article (256palett_bas) in a 
slightly amended form to make it easier to com- 
pile. You can scroll through the colours by pres- 
sing the up and down arrow keys. Dont forget 
that to use these colours in your programs you 
il have to add 256 to the numbers shown 
against the colour. 

Now the RGB colours. Reproduced with this 
article is the short basic program (WMRGB_bas) | 
wrote for my own use when | was learning about 
the new colours. What | like about this program is 
that it helos you to learn how the colours are 
made up from the Red, Green and Blue compo- 
nents. Press the r g, and b keys to increase the 
proportion of red, green and blue respectively. To 
reduce the amount of each colour press shift 
plus r @ or b. The up arrow key increases all co- 
lours together and the down arrow key reduces 
it, 

However if you want to do choose colours in a 
more professional way, the program to use is 
QCP which stands for QL Colour Picker by 
Wolfgang Uhlig. You can download this from his 
website: 

www.uhlich.nl/ql 


= 


lf you look at the screen shot of this program. 
You will see a large window on the left hand side 
with a cursor in the shape of a circle. You can 
move this cursor around to choose the colour 
you want, which is displayed in the square just 
right of centre. If necessary you can adjust the 
rightness of the colour by the strip next to the 
arrow. SystemColour gives you the number you 
have to input to get that colour in your program 
and you can put this in the stuffer buffer to be 
dropped in your program when you press ALT + 
SPACE. 


a 


You will notice the number is in HEX, but there Is 
no need to panic as SMSQ/E has a routine for 
converting this to decimal: 

The command PRINT HEX("AB83") gives the 
answer 43907. The window manager colours 
also allow you to enter hex values so you could 
enter that colour into your program as either: 
WM_PAPER 43907 Of WM_PAPER $AB83 

You now have all you need to know to 
experiment with the new colours in your own 
programs. 


256palett__bas 


100 OPEN #0,con : out=0 

4110 WINDOW #out, 16%*10+2, 16%*10+2,50,50 
120 COLOUR_PAL : BORDER #out,1,0,1 

130 bottom=-16 

140 FOR i= 1 TO 16: up 

150 REPeat up_down 

160 BGET #0,a 


170 IF a=208 : IF bottom 255-16 : up 
180 IF a=216 : IF bottom 0 : down 
190 END REPeat up_down 

200 : 


210 DEFine PROCedure up 

220 bottom=bottom + 1 

230 PAPER bottom + 15 :SCROLL -10 

250 i=bottom+1015 : I$=i 

270 PAPER #out, i&&1 : INK #out, (i+1) &&1 
280 AT #out,15,0 : PRINT #fout,I$(2 TO 4) 
290 END DEFine 


320 DEFine PROCedure down 
330 bottom=bottom — 1 

340 PAPER bottom : SCROLL 10 
350 isbottom+1000 :I$=i 
380 PAPER #out, i&&1 : 
390 AT #out,0,0 : 
400 END DEFine 


INK #out, (i+1) &&1 


PRINT #out,1$(2 TO 4) 


EG 
Ccoveoas 


WMRGB.__bas 


100 WINDOW 250,150,0,0 

110 BORDER 2,248 

120 PAPER 0 : INK 7: CLS 
130 red=0 : green=0 : blue=0 
140 print_colours 


150 REPeat change 
160 e$=INKEY$(-1) 
170 e=CODE(e$) 
180 SELect ON e 


190 = 114 : REMark r key — increase 
red 
200 red=red+1 
210 = 82: REMark Shiftt+r key - 
decrease red 
220 red=red-1 
230 = 103 : REMark g key - increase 
green 
240 green=green+1 
250 = 71: REMark Shift+g key - 
decrease green 
260 green=green-1 
270 = 98 : REMark b key ~- increase 
blue 
280 blue=blue+1 
290 = 66: REMark shiftt+b key - 
decrease blue 
300 blue=blue-1 
310 = 208 : REMark Up cursor key - 
increase brightness 
320 red=red+1 : green=greentl : 
blue=blue+1 
330 = 216 : REMark Down cursor key : 
decrease brightness 
340 red=red-1 : green=green-1 : 
blue=blue-1 


350 END SELect 
360 IF red>30: 
370 IF green>30 : green=31 

380 IF blue>30 : blue=31 

390 IF red«1l : red=0 

400 IF greenci : green=0 

410 IF blue«1 : blue=0 

420 print_colours 

430 END REPeat change 

440 : 

450 DEFine PROCedure print_colours 


red=31 


460 AT 3,23 : PRINT "Red: ";red;" " 

470 AT 5,23 : PRINT "Green: ";green;" " 
480 AT 7,23 : PRINT "Blue: ";blue;" " 
490 Colour=32768 + 1024*red + 32*green 


+ blue 
500 AT 9,23 : PRINT "Colour: ";Colour 
510 WM_BLOCK 100,100,15,15,Colour 
520 END DEFine 


Colours. 43¢ 


The latest version of SMSQE has an inbuilt sup- 
port for a “Home directory thing’. This may be of 
interest to some users, So here is a small descrip- 
tion of it. 


| — What does it do? 


A - Home directory 

The HOME thing implements "home directories’. 
A home directory in this context is defined as 
meaning the directory from which an executable 
file was executed. Thus, if you have a file called 
fred_exe In a directory wini_progs_exec_ the 
home directory for that file wil be 
wini_progs_exec_ 


The usefulness of this will vary enormously, de- 
pending on whether YOU make use of it in your 
programs. 


B - Home Filename 
The home thing also supplies what, for want of a 
better name. I'll call the "home filename’ which Is 


the combination of the filename and the home 
directory, thus making up the complete SMSQ/E 
filename - in the example above this would be 
winl_progs_exec_fred_exe. 


Both home directory and home filename are set 
up once and for all when the program starts, and 
are deleted when the program is removed. With 
one exception, they are immutable: once set, 
they may not be changed. They are just removed 
upon removal of the program itself 


C - Current Directory 

The Home Thing also implements a ‘current di- 
rectory”. This is inherited from the job that is set- 
ting up the home directory (in most cases the pa- 
rent job). If the calling job does not have a cur- 
rent directory, a copy of the home directory is 
used instead. 


The current directory can only point to a valid 
directory, Within that limit it may be set/reset or 
otherwise manipulated by the job itself. 


D - Default Directory for named jobs 

Finally, there is also a default home directory for 
jobs that are executed through other means, 
perhaps through file managers that don't use the 
HOME thing, or especially, through hotkeys. Due 
to the enormous variations that can exist in situa- 
tions where jobs are executed from hotkeys, and 
while there is no problem when jobs are loaded 
from a file through a hotkey, sometimes the job 
code is already in memory, but no job with the 
name exists until the hotkey is actually pressed 
‘executable things’), sometimes the job exe- 
cutes immediately etc. In those circumstances, it 
will not always be possible to associate a job 
with a filename and directory, 

It is, however possible to set up a default home 
directory for jobs with a given name. When a job, 
for which a default directory was set up, exe- 
cutes, for example from a hotkey, and tries to 
get at its home directory, a home dir will be set 
up for it automatically. 

Thus, whenever a job tries to find its home/ 
current directory/file and they can't be found di- 
rectly because they haven't been defined for that 
job, a check is also made in the default list. If the 
job's name is in the default list, then an entry for 
that job, with that default filename, is made in the 
home directory list. 


Il — Can it work for You? — 
SMSQ/E and QDOS 


For the home directory scheme to work, the 
cooperation of the operating system or file 
manager(s) is needed: Indeed, whenever a job is 
executed, whoever is doing this executing must 
explicitly set up the home directory for the jobs 
that is being executed. Here, there is a difference 
between SMSQE and QDOS. 

SMSQE now has the HOME Thing built in, and 
also support for it (see below for QDOS). Typical- 
ly. on an SMSQ/E system, jobs will be started up 
through the EX(ec) command variants, through 
filemanagers such as QPAC ll or through Filelnfo. 
Finally, SBasic programs may also be loaded: 


A- The EXlec) etc command 

Support for the Home Thing is built into the OS 
as of SMSQ/E version 3.11. Whenever you use 
the EX commands, the home directory for the 
job to be EXecuted will be set up automatically. 
This support does not exist on QDOS machines, 
since, obviously, the EXEC command itself had to 
be modified, which is not possible under QDOS. 


B - QPAC II and other file managers 

QPAC || has already been altered to take the new 
home thing into account. All file managers will 
need to be changed to support the home direc- 
tory. If you are a programmer and have pro- 
grammed a file manager, further information is 
given below, showing you the code that needs to 
be implemented for this. If a filemanager Is in 
compiled basic (e.g. DiskMate) no further action 
will be necessary under SMSQ/E since the EX 
commands in SMSQ/E will do whathever is ne- 
cessary. 


C - Filelnfo 

Thierry Godefroy has modified Fileinfo | to use 
the Home Thing. For the record, | have modified 
my own Filelnfo (the initial Fileinfo} to use the 
home thing, if present. 


D - Basic 

Under SMSQE, whenever you (qjload/{qa)merge a 
basic program, the home directory for that basic 
program is set to the file just loaded. Thus basic 
is again an exception - it is the only job for which 
the Home directory may change. 


E - QDOS and the HOME Thing 

There is a stand alone version of the HOME thing 
for QDOS users (which can be downloaded at 
http://www.scp-paulet-lenerz.com/14mljkl24/wolf/ 
download/) 


Thus, QDOS systems can also profit from the 
home directories set up from QPAC |I and Fileinfo, 
but support for the HOME thing through the Ex 
and LOAD commands will be non-existent, since 
that requires a change in these commands. The 
same is true for filemanagers that are compiled 
basic. 


III — How to load the HOME Thing 


The HOME thing is already present in SMSQE v, 
3.11 onwards and doesn't need to be loaded. 


On Qdos, use: 

a=RESPR (file_length) 
LBYTES «device>_home_bin,a 
CALL a 


or the LRESPR variants if your system has them. 


New Websites! 


We are proud to present our new websites! 
Starting September, we have separated our business in three 
separate websites. 


You can find them at: 
< http://www. rwapadventures.com/> (Adventure Games) 


<http://www.rwapservices.co.uk/> (General Site) and 


<Http://www.rwapsoftware.co.uk/> (Software) 


New Products! 


£0 Nowwan 
#6 SOUND ON GCA 


The wait is now over! Q-Word version 1 is finally available! 


Platforms: 
QPC/QXL, Q40/Q60, Aurora (with SGC) 


Prices: 
All versions without P-Word £20.00p 
All versions with P-Word £30.00p 


Notes: 

Q-Word DOES NOT require SMSQ/E with GD2 support -OR- SMSQ/E at all on 
the Aurora or Qx0 machines. it works on the highest colour depth everywhere 
regardless of Operating System. 

The Aurora version is available on either HD or EO disk. For the fatter add 
£1.00 to the price. ED version is uncompressed and can be run directly from 
the floppy. All other Floppy versions are compressed. QPC/QXL version 
comes on CD. Non CD versions DO NOW support digital sound on QPC2 


Quantum Leap ED Drives 


After many years of unavailability, here they are again! These are 
high quality Mitsubishi constructed/IBM badged drives with full 
warranty. 

Unlike previously sold ED drives, these do not require 
FLP_JIGGLE and have no problems formatting 720K disks. 
However for the latter a switch is included with the cable. 


ED Bare unit (no cable) £ 29.99p 
ED Boxed unit (complete with cable/ PSU) £ 98.99p 
Single unit Cable (with switch) £ 4.99p 
Dual unit Cable (with two switches) £ §.99p 


(More options available, contact us for details. Also available mass quantities 
of EDand DD disks!) 


for Windows 


For QLers that run Windows or with incompatible hardware for 
Talent Games, we now have re-released these adventures so that 
they can run on your Windows-equipped PC. No Emulator, 
floppies, microdrive backups etc. required, just a one-click install! 
Of course the full QL line is still available! (See side column) 


Talent Games for Windows ea. £ 10.00p 
(Each Game includes a runtime installation of QLAY-2 by Jimmy Montesinos) 


Old Favourites! 


Utilities 
Sidewriter v1.08 £10.00p 
Landscape Printing (EPSON printers) 
ImageD v1.03 £ 10.00p 
3D object generator 
Q-Help v1.06 £10.00p 
Superbasic On-Screen heip system 
Q-index v1.05 £ 5.00p 
Keyword-to-topic finder 
ProForma ESC/P2 Drivers v1.04 for ProWeSs £ 8.00p 
Printer Driver 
Applications 
Flashback SE v2.03 (upgrade only) £ 5.00p 
Database 
QL Cash Trader v3.7 £ 5.00p 
Accounting/Finance 
QL Payroll v3.5 £ 5.00p 
Accounting/Finance 
QL Genealogist v3.26 £ 20.00p 
Genealogy 
Genealogy for Windows £ 50.00p 
QL Genealogist to Windows version upgrade £ 25.00p 
QL Cosmos v2.04 £ 5.00p 
Planetarium 
Q-Route v2.00 £ 25.00p 
Route Finding 
Upgrade from v1.xx £ 5,00p 
Britain map v1.14 £ 2.00p 
BIG Britain map (needs 2Mb) v2.03 £ §6.00p 
Various Britain Area maps (ask for details) ea. £ 2.00p 
ireland map v1.00 £ §.00p 
Belgium map v1.01 £ 2.00p 
Catalonia map v1.03 £ 2,00p 
P-Word UK English Dictionary (500.000 words!) £15.00p 
Dictionary 
Leisure 
Return to Eden v3.08 £10,00p 
Adventure 
Nemesis Mkil v2.03 £ 8.00p 
Adventure 
The Prawn v2.01 £ §8.00p 
Adventure 
Horrorday v3.1 £ 8.00p 
Adventure 
West v2.00 £ 5.00p 
Adventure 
The Lost Kingdom of Zku! v2.01 £ 5.00p 
Adventure 
All 6 games above £ 25.00p 
D-Day Mkil v3.04 £10.00p 
Strategy/War Simulation 
Grey Wolf v1.08 £ 8.00p 
Graphical Submarine Simulation 
War in the East MkH v1.24 (upgrade only) £ 5.00p 
Strategy/War Simulation 
Open Golf v5.20 £ 8.00p 
Sports Simulation 
QuizMaster II v2.07 £ §.00p 
Quiz 
Stone Raider Il v2.00 £ 5.00p 
Arcade Game 
Hoverzone v1.2 £ 5.00p 
Arcade Game 
Deathstrike v1.5 £ 5.00p 
Arcade Game 
Flightdeck v1.0 £10.00p 
Flight Simulation 
Ait 6 games above (Open Golf, QuizMaster II,Stone 
Raider |i, Hoverzone, Deathstrike and Flightdeck) £ 28.00p 


Notes on Software requirements 
The following programs have a minimum SGC card requirement: P-Word, 
Qword, Big Britain MAP for Q-Route 


178 Newtown Road, Bedworth, Warwickshire, CV12 8QN, United Kingdom. Tel: +44 2476 490616 (From the UK dial: 02476 490616) 


Website: http:/Avww.rwapsoftware.co.uk 
We accept: 


NOCHE 
Seeewarl WOAEY 
[PREFERREG BAveeenT 


| 


[MERTF Leo 


(For PayPal please add 4% to the total price. Cheques in £ sterling made payable to R. Mellor) 


IV — Using the HOME Thing 
A - From SBasic 


There are several new SBASIC keywords for 
this. 


1 - Get the home directory 
result$ = HOME_DIRS$(job_id) 


This function returns the home directory for the 
job given as job_id. To avoid programs stopping 
with an error if for some unimaginable reason the 
home directory cannot be found this function re- 
turns an empty string if that error happens. 

The job ID is optional, in that case -1, meaning 
the current job, will be assumed. 


E.g.: 


100 define procedure init 
110 mydir$ = HOME_DIR$ 


2 - Get the home filename 
result$ = HOME_FILE$(job_id) 


Same as for the home directory, but for the 
home filename. 


3 - Get the current directory 
result$ = HOME_CURR$(job_id) 


Same as for the home directory, but for the 
current directory, 


4 - Default names 
HOME_DEF job_name$, file_name$ 


This sets a default filename for a job with the 
name given as first parameter This is useful for 
“executable things’, where no filename is readily 
available, or for file managers that haven't inte- 
grated calls to the home thing. Please refer to 
the section I-D above for more information on 
this. 


With this keyword, you set up the default job 
name and filename that is to be used for the 
home/current file/dir 


Please note that the file.name$ parameter must 
indeed be a FILENAME. not a directory name. 


Example: 
HOME_DEF "Sbasic", "devi_sbasic_test_bas" 


5 - Get the version of the HOME thing 


result$ = HOME_VER$ 


B - From machine code 


The thing can of course also be called from 
machine code. It implements various extensions 
- it is an extension thing. 


There is some ready to use wrapper code in the 
SMSQ/E source tree, namely in the file 
‘util_gut_-home_asm’. If you still want to go the 
manual route, here is the documentation for the 
different extensions: 


To use them, in short, first you USE the thing (AO 
= thing name, D2 = extension). You might want to 
make sure you use a Call that returns the pointer 
to the thing linkage base in A2 and a pointer to 
the thing in Al as these will be expected when 
Calling the call routine. (If you have access to the 
SMSQE sources, a good vector for this is 
gu_thjmp). 

The name of the thing is, imaginatively, "HOME’, 
and the names of the individual extensions will be 
given below, 


After you have used the thing, you then call the 
thh_code routine of the thing with A2 pointing to 
the linkage and Ai to a parameter list. 


Each extension thus has its own parameter ist, 
They are explained below for each extension. An 
example for using the thing from machine code 
could be as follows, to SET the default name/dir 
(this uses the gu_thimp routine from the SMSQE 
sources, which returns the correct values in Al 
and A2). 


It is presumed for this example that, on entry, Dt 
contains the job ID of the job for which the 
directory/file is to be set, that the job name, for 
which a default is to be set up can be found at 
label called ‘jobname’ and that the filename for 
this job can be found at a label called ‘filename’. 


homereg a0Q-a4/d0-d3 


distak 


reg 
equ 4 
3 where D1 is on stack 


setdflt 


movem.1 homereg,—(sp) 


lea 
moveq 
moveq 


move.1 


moveq 
jsr 

tst.1 
bne.s 


move.1 


sub.1 


move.1 
move.1 


lea 


move.1 
move.1 


lea 


move.1 


jer 
add.1 
lea 
moveq 
moveq 
jer 
no_thg 


home_name, a0 
#-1,d3 
#-1,d1 
#'SETD',d2 
#sms.uthg, d0 
gu_thjmp 

do 

no_thg 

al,a0d 

#16,sp 

sp,al 


#$c1000000, (a1) 


jobname, a4 


a4,4(al) 


#$c1000000, 8(a1) 


filename, a4 
a4,,12(al) 
thh_code(a0) 
#16,sp 
home_name, a0 
#sms.fthg,d0 
#-1,d1 
gu_thjmp 


movem.1 (sp)+,homereg 


Coge) 


home_name 
de.w 


4, "HOME! 


The extensions are as follows: 


GETH 
GETF 
GETC 


Nes Nee Nee See Nee Woe Noe See we ee ee Noe Woo tee we oe ee ee Nee wo Oe 


keep my regs 

point to name of thing 

wait forever 

I will use the thing 
extension in thing to use 
use thing 

on return A2= ptr thg header, al to thg 
ok? 

no, ignore 

pointer to thing (!!!) 

get some space 

and point to it 
thp.call+thp.str 

point to jobname to set 

set pointer to this string 
thp.call+thp.str 

point to file/dirname to set 
set pointer to this string 
call extn thing 

reset stack 

now free thing, ignore error on call 


free thing 


ignore error 


Respectively get the home directory, home filename and current directory. 


entry exit 


DO 
D2 


Al pointer to parameter list 
A2 pointer to thing linkage 


The parameter list is as follows: 


word 
word 


ong word 


ong word 


O or error 
buffer size needed (errorng) 
preserved 
preserved 


job id of job for which info is to be gotten 


$SA100 (corresponding to thp.str+thp.ret) 
length of buffer for return string 


pointer to buffer for return string 


The routine will return 0 if no error occurred, erritnf if the job with the given ID doesn't have a 
home directory and errorng if the buffer is too small for the entire directory/filename. In this latter 
case, the routine will not touch the given buffer but just return the needed size in D2. 


SSS SS Se 


SETD 


set the default directory for a given name. 


entry exit 
DO O or error 
Al pointer to parameter list preserved 
A2_ pointer to thing linkage preserved 


The parameter list is as follows: 
Ofat) long word 
Afal) long word 
(al) long word 
12(al) long word 


V — Setting up a HOME Directory 


Normally, jobs should not try to set up a home 
directory for themselves. This should be left to 
the system/filemanager When a job is started 
with the SMSQ/E EX, EW or any of the similar 
commands, this is done automatically. However 
filemanager writers may be interested in this info. 


A- From Sbasic 


HOME_SET job_id, device_and_file_name$ 


Set the home directory, home filename and 
current directory. You pass the thing the job ID of 
the job for which this is to be set up and the 
entire filename, including the device and directory. 
The thing extracts the home directory from the 
filename. If you want to set up the home directo- 
ry for the current job, you may pass ~1 as para- 
meter. 


SETH 


This sets the home directory, 


DO 
Al pointer to parameter list 
A2 pointer to thing linkage 


The parameter list is as follows: 
O{al) long word 
4(al) long word 
8(al) long word 


entry exit 


job id of the job for which this is set 
$C1000000 (corresponding to thp.str+thp.call) 
pointer to string for entire filename 


The routine will return 0 if everything went OK else any error from the memory allocation 
routine or errfdiu if the job with this job ID already has a home directory set up. 


$C1000000 (corresponding to thp.str+thp.call) 
pointer to string for jobname 
$C1000000 (corresponding to thp.str+thp.call) 
pointer to string for filename 


Since there can only be one home directory for a 
job and since that can only be defined once, the 
keyword will give an error if the home directory 
is already set for this job. Otherwise, this 
keyword will set the home directory, the home file 
and the current directory, 

This keyword exists mainly for testing purposes. 


B - From Machine Code 


Please read the general rules on how to use the 
thing from machine code (section IV above}. The 
extension to use here is SETH. to SET the home 
name/dir (this uses the gu_thimp routine from the 
SMSQE sources, which returns the correct 
values in Al and A2). 


It is presumed here that, on entry D1 contains 
the job ID of the job for which the directory/file is 
to be set and that the filename for this job can 
be found at a label ‘filename’. 


O or error 
preserved 
preserved 


The following is an example of a routine that can use this to SET the home name/dir (this uses the 
gu_thimo routine from the SMSQE sources, which returns the correct values in Al and A2). 


It Is presumed here that, on entry Di contains the job ID of the job for which the directory/file is to be 
set and that the filename for this job can be found at a label ‘filename’. 


homereg 
reg a0-a4/d0-d3 
distak equ 4 ‘ 

sethome 
movem.1 homereg,—(sp) ; 
lea home_name , a0 ; 
moveq #-1,4d3 5 
moveq #-1,d1 iH 
move.1 #'SETH',d2 ; 
moveq #sms.uthg,d0 : 
jsr gu_thjmp ; 
tst.1 dd . 
bne.s no_thg ; 
move.1 ai1,a0 j 
move.1 distak(sp),d1 H 
sub.1 #12,sp ‘ 
move.l sp,al 7 
move.l di, (ai) ; 
move.l #$c1000000,4(a1) 7 
lea filename, a4 7 
move.1l a4,8(a1) ; 
jsr thh_code(a0) ; 
add.1 #12,sp ; 
lea home_name, a0 j 
moveq #sms.fthg,d0 
moveq #-1,d1 
jsr gu_thjmp ; 

no_thg 
movem.1 (sp)+,homereg j 

(...) 

home_name 

de.w 4,'HOME! 


where D1 is on stack 


keep my regs 

point to name of thing 

wait forever 

I will use the thing 

extension in thing to use 

use thing 

on return A2= ptr thg header, al to thg 
ok? 

no, ignore 

pointer to thing (!!!) 

get job ID back 

get some space 

and point to it 

insert ID of job 

thp.call+thp.str 

point to file/dirname to set 

set pointer to this string 

eall extn thing 

reset stack 

now free thing, ignore error on call 


free thing 


ignore error 


Finally, I'd like to point out that, whilst | have divised the home thing initially, Marcel Kilgus later recoded 
much of the code and also implemented some better ideas of his. 


Much maligned, Quill still has its uses. Fancy using 
it to transfer text to a PC? How about generating 
some HTML code? Or exporting Quill DOCs as 
simple plain text? 


This is a set of five printer_dat files for Quill or 

Xchange intended to allow Quill to perform 5 

special functions: 

1. Print to HP Deskjet printers (also works on 
some Laserjets) (HPDJ_printer_dat) 

2. Generate simple plain text files with QL-style 
linefeed end of lines (QLplaintext_printer_dat) 


3. Print to a plain text file with carriage returns 
added to end of lines for transfer to PCs, and 


translation of character codes below 128. 
(QLtoPCtext_printer_dat) 

4 Print the text file as a simple HTML file (HTML_ 
printer_dat) although this driver only works on 
the Xchange version of Quill (code sequences 
too long for standard QL Quill and cause an 
error due to failure to read the printer_dat) and 


may need to be renamed to xchange_dat. 


5. Assume the loaded document is a text file 
transferred from a PC, so print it as a QL text 
file with translation of commonest character set 
differences. (PCtoQLtext_printer _dat) 


While preparing files to be printed as plain text 
or example, ensure you set the correct upper 
and lower margins and the correct header and 
footer settings. With headers and footers off and 
top and bottom margins set to 0 and page length 
set to 255 lines you stand the best chance of 
generating true plain text files. If you set page 
ength to 0 as in this driver and leave page 
ength at 66 in the document, what youll get is 
every 66 lines two lines joined together, as Quill 
does not issue end of line characters after the 
ast line in a page. 


With all of these drivers, you should print the out- 
put from Quill to a file (using the Print commands 
in Quill) and ensure that the correct printer_dat 
from the list above is copied to have a filename 
of printer_dat. Then execute Quill from the same 
disk and PRINT the file. Note that Quill does not 
allow you to change printer_dat during a session, 
S 
q 


— 


O if you wish to use a different driver you must 
uit from Quill and start it again. 


short BASIC program select_printerdat_bas is 

so supplied. This simply asks you to select one 
of the 5 printer_dats supplied, deletes the exist- 
ing one and copies the selected one in its place. 
4 of the 5 printer_dats are in the supplied 
install.dat file, the master file for use with 
install_obj. | could not put the HTML driver in as It 
contains longer code sequences than allowed by 
install_obj or Psion Quill. It can only be used with 
Xchange. 


o > 


Here is a list of how the printer_dats have been 
built These can be entered using Quill’s 
INSTALL_BAS program to create the individual 
drivers. 

Or if you have internet access, you can down- 
load ready made files along with a few other 
useful files from my website: 
www.dilwyn.uk6.net/psions/index.html 


1. HPDJ_PRINTER_DAT 

Assumes a serial port (PAR) is being used. The 
preamble issues a carriage return to ensure that 
the first line is printed at the left margin in case 
use of a previous program left the print position 
somewhere in the middle of a line then sets the 
line termination to translate a QL single linefeed 
to carriage return+linefeed. Postamble is set to a 
form feed to ensure the last page Is ejected from 


the printer important in the case of a Laser prin- 
ter for example. The character translations are a 
miscellaneous set | happened to find useful. Sub- 
script is actually half height text, while superscript 


becomes italic, which | 


DRIVER NAME 
PRINTER PORT 
LINES PER PAGE 
CHARACTERS PER LINE : 
FORMS TYPE 

END OF LINE CODE 
PREAMBLE CODES 
POSTAMBLE CODES 
BOLD ON CODES 

BOLD OFF CODES 
UNDERLINE ON CODES 
UNDERLINE OFF CODES 
SUBSCRIPT ON CODES 
SUBSCRIPT OFF CODES 
SUPERSCRIPT ON CODES 


SUPERSCRIPT OFF CODES : 
FROM 96 (') TO 175 


TRANSLATE 1: 
TRANSLATE 2: 
TRANSLATE 3: 
TRANSLATE 4: 
TRANSLATE 5: 
TRANSLATE 6: 
TRANSLATE 7: 
TRANSLATE 8: NONE 
TRANSLATE 9: NONE 
TRANSLATE 10: NONE 


FROM 127 
NONE 
NONE 
NONE 
NONE 
NONE 


found more useful. 


: HP Deskjet 
> SERL 


: Continuous 


2-10 

: 13,27,38,107,50,71 
: 12 

: 27,40,115, 51,66 

: 27,40,115,48, 66 

: 27,38,100,49,68 

: 27,38,100, 64 

: 27,40,115,54, 86 

: 27,40,115,49,50, 86 
: 27,40,115,49,83 
27,40,115,48, 83 


( ) TO 99,8,79 


2. QLPLAINTEXT_PRINTER_dat 


Assumes printing to SERL and QL-style linefeed 
only at the end of lines. 
Generates the simplest of plain text files from 


Quill DOC files. 


DRIVER NAME : QL PLAIN T 
PRINTER PORT : SERL 
PARITY : NONE 
BAUDRATE : 9600 
LINES PER PAGE : 0 
CHARACTERS PER LINE : 80 
FORMS TYPE : Continuous 
END OF LINE CODE 10 
PREAMBLE CODES : NONE 
POSTAMBLE CODES : NONE 
BOLD ON CODES : NONE 
BOLD OFF CODES : NONE 
UNDERLINE ON CODES : NONE 
UNDERLINE OFF CODES : NONE 
SUBSCRIPT ON CODES : NONE 
SUBSCRIPT OFF CODES : NONE 
SUPERSCRIPT ON CODES : NONE 
SUPERSCRIPT OFF CODES : NONE 
TRANSLATE i: NONE 

TRANSLATE 2: NONE 

TRANSLATE 3: NONE 

TRANSLATE 4: NONE 

TRANSLATE 5: NONE 

TRANSLATE 6: NONE 

TRANSLATE 7: NONE 

TRANSLATE 8: NONE 

TRANSLATE 9: NONE 


TRANSLATE 10: NONE 


3. QLtoPCtext_printer_dat 

Similar to the plain text driver, but issues carriage 
return and linefeed at the end of lines ready for 
transfer of text files to a PC. Converts bold text 
to *bold text* as seems to be the convention 
with email and other texts. Normally, _” would 
indicate italics, but Quill does not support italics, 
so | have made underlined text be preceded by 
‘_’ and followed by '_.. The Pounds is converted 
to CHR$ 156 to help match the PC character set 
and Euro symbol is translated to a simple capital 
E, as not all PC character sets include a Euro 
symbol. The Copyright symbol is converted to 
(C), which will alter line lengths slightly. 


DRIVER NAME : QLtoPCtext 
PRINTER PORT : SERL 
PARITY : NONE 
BAUDRATE : 9600 

LINES PER PAGE 2.0 
CHARACTERS PER LINE : 80 

FORMS TYPE : Continuous 
END OF LINE CODE 713,20 
PREAMBLE CODES NONE 
POSTAMBLE CODES NONE 
BOLD ON CODES : 42 

BOLD OFF CODES : 42 
UNDERLINE ON CODES : 95 


UNDERLINE OFF CODES : 95 


SUBSCRIPT ON CODES NONE 
SUBSCRIPT OFF CODES NONE 
SUPERSCRIPT ON CODES NONE 
SUPERSCRIPT OFF CODES : NONE 


TRANSLATE 1: FROM 96 (') TO 156 
TRANSLATE 2: FROM 181 (&) TO 69 
TRANSLATE 3: FROM 127 ( ) TO 40,67,41 
TRANSLATE 4: NONE 

TRANSLATE 5: NONE 

TRANSLATE 6: NONE 

TRANSLATE 7: NONE 

TRANSLATE 8: NONE 

TRANSLATE 9: NONE 

TRANSLATE 10: NONE 


4, HTML_printer_dat 
Prints the file as a fairly simple equivalent format 
HTML page. 


DRIVER NAME HTML 
PRINTER PORT none 

LINES PER PAGE : 66 
CHARACTERS PER LINE : 80 

FORMS TYPE : Continuous 
END OF LINE CODE : 10 


: 60,72,84,77,76,62,60, 
72,69,65,68,62,60, 84, 
73,84, 76,69,62,81,117, 
105,108,108,32,116,111 
732,72,84,77,76,60,47, 
84,73, 84, 76,69,62,60, 
47,72,69,65,68,62,60, 
66, 79,68,89,62,10,60, 
80,82,69,62 

: 60,47,80,82,69,62,60, 
47,66,79,68, 89,62, 60, 
47,72,84,77,76,62 


PREAMBLE CODES 


POSTAMBLE CODES 


BOLD ON CODES 
BOLD OFF CODES 


: 60,83,84,82,79,78,71,62 
: 60,47,83,84,82,79,78,71,62 


UNDERLINE ON CODES : 60,85,62 
UNDERLINE OFF CODES : 60,47,85,62 
SUBSCRIPT ON CODES : 60,83,85,66,62 
SUBSCRIPT OFF CODES : 60,47,83,85,66,62 
SUPERSCRIPT ON CODES : 60,83,85,80,62 
SUPERSCRIPT OFF CODES : 60,47,83,85,80,62 


TRANSLATE 1: NONE 
TRANSLATE 2: NONE 
TRANSLATE 3: NONE 
TRANSLATE 4: NONE 
TRANSLATE 5: NONE 
TRANSLATE 6: NONE 
TRANSLATE 7: NONE 
TRANSLATE 8: NONE 
TRANSLATE 9: NONE 
TRANSLATE 10: NONE 


5. PCtoQLtext_printer_dat 

Assumes that the file is an imported PC text file, 
SO does some character translation (Pound sym- 
bol, back tick and copyright symbol) and prints 
with linefeed only at the end of each line. 


DRIVER NAME : PCtoQLtext 
PRINTER PORT : SERL 
PARITY : NONE 
BAUDRATE : 9600 

LINES PER PAGE : 0 
CHARACTERS PER LINE : 80 

FORMS TYPE : Continuous 
END OF LINE CODE : 10 
PREAMBLE CODES : NONE 
POSTAMBLE CODES NONE 
BOLD ON CODES : 42 

BOLD OFF CODES : 42 
UNDERLINE ON CODES > 95 


UNDERLINE OFF CODES : 95 


SUBSCRIPT ON CODES NONE 
SUBSCRIPT OFF CODES NONE 
SUPERSCRIPT ON CODES NONE 
SUPERSCRIPT OFF CODES : NONE 


TRANSLATE 1: FROM 156 (£) TO 96 
TRANSLATE 2: FROM 96 (') TO 159 
TRANSLATE 3: FROM 184 (6) TO 127 
TRANSLATE 4: NONE 

TRANSLATE 5: NONE 

TRANSLATE 6: NONE 

TRANSLATE 7: NONE 

TRANSLATE 8: NONE 

TRANSLATE 9: NONE 

TRANSLATE 10: NONE 


Selecting The Required Driver 
The little SuperBASIC program on the next page 
will help you copy the driver for the Quill ope- 
ration you need. Since Quill only looks once for a 
printer_dat. copy the driver required first, then 
Start Quill. If you need to change driver, you have 
to quit from Quill, install the new driver and restart 
Quill. Note that the program assumes it's running 
from FLP1_ (see line 110) 


100 REMark select printer_dat 

110 device$ = 'FLP1_' 

120 RESTORE 

130 DIM names$(4,40) 

140 FOR a = 0 TO 4 : READ names$(a) 
150 DATA 'HPDJ_printer_dat' 

160 DATA 'QLPlainText_printer_dat' 
170 DATA 'QLtoPCtext_printer_dat' 
180 DATA 'Html_printer_dat' 


190 DATA 'PCtoQLtext_printer_dat' 

200 : 

210 CLS 

220 FOR a = 0 TO 4 : PRINT at+1;' — ';names$(a) 


230 INPUT\'Select which printer_dat file:';ip% 


240 IF ip% = 0 THEN STOP 
250 DELETE device$&'printer_dat'! 


260 COPY device$&names$(ip%—-1) TO device$&'printer_dat' 


Robert Hartung writes: 

My thanks to all who made the current Vol. 10 
Issue 3 one of the best in years! | especially 
appreciated Dilwyn Jones’ Insider CD containing 
QL/QDOS/SMSQ documentation from day one 
to the present. | missed out on buying the prin- 
ted Reference work on this while it was available, 
so now | have those original documentations 
plus updates in one source. Even though | 
havent kept up with buying all the latest and 
greatest HW and SW as it became available, as a 
Sinclair aficionado and sometimes programmer 
since 1980 | still enjoy reading about it all. 

Having said that, | am also much interested in 
QPCPrint in case my last two remaining parallel 
port ESC/P2 printers go down. | downloaded the 
demo and manual for it, but after repeated 
attempts, somehow my 81-year + brain doesn't 
seem to grasp how to set it up in my QPC2 
v.3.02 so | can output to my USB Epson CX4600 
printer | mostly want to print out files from Quill 
and Abacus as they are set up presently to print 
with Epson 510 and Canon BJ 210 configuration. 

s there someone out there who would be so 
kind as to take me by the hand and, taking 
nothing for granted, lead me step by step 
through the necessary procedure? If | seem to 
be the only one who needs this, | would greatly 
appreciate an email to my address below. If 
there seem to be others, no doubt a short article 
in QL TODAY would be much appreciated by all. 


Editor's reply: 

Thank you very much for the compliments. Issue 

3 was an issue which was a pleasure to produce 

- no rush, no chase for articles as enough 

material was waiting for us. 

We tried to find out if there was any demand for 

QPC Print trouble shooting. QPC Print seems to 

be a trouble-free product. Easy to install, easy to 

set up - just a few easy steps. We tried to think 
of problematic areas. Here is what we came up 
with: 

1. Check that your printer is working fine under 
Windows - otherwise QPC Print obviously 
cannot work. 

2. Ensure that you have installed QPC Print into 
the same directory in which you have installed 
QPC. 

3. In the QPC SER/PAR dialogue, the ‘filter’ box 
next to the selected printer needs to be 
ticked (if you forget it, the printer will only print 
garbage or nothing, as QPC Print does not 
come into play without this box. 


Well, and that's about it. As you seem to be 
printing to an EPSON compatible printer or an 
EPSON itself, no need to change anything inside 
QPC. You can type a BASIC line to see if the 
printer prints something, like 


JOBS \PAR1 


to print to the printer defined to be PARI. 


This is a small set of superbasic functions to 
handle filenames. 

When writing programs to handle files on a 
system which supports directories, it is hard to 
resolve the directory and filename parts. Since 
Qdos doesn't really make a distinction between 
directories and filenames, it's hard to write code 
which copes well with moving files between 
directories and so on. 
So | wrote these functions to help with this task. 
| suppose that these functions could be seen as 
a kind of filename parser. 

Supposing we have a program 
MYPROG_EXE which has been saved 


called 
into a 


directory called PROGS on drive wint_. The full 
filename would be: 

wini_PROGS_MYPROG_EXE 

These functions will helo to break down (or 
parse) the filename given to help us handle and 
manipulate files. Where the user explicitly gives 
filenames, this is not usually necessary, but sup- 
pose we need to write a program which looks at 
all the files in a directory and copies or moves 
these files to another directory, We need code 
which can break down the filename into all its 
various elements and handle and _ adjust 
filenames as a result. 


A list of the functions to extract drive name. directory name, pure filename and extension name 


individually: 


10000 DEFine FuNection Directory_Name$ (filename$) 


10010 LOCal ch,d$ 

10020 ch = FOP_DIR(filename$) 
10030 IF ch< O THEN 

10040 d$ = '! 

10050 ELSE 

10060 d$ = FNAME$(#ch) 
10070 IF d$ > '' THEN 
10080 IF d$(LEN(d$)) <>» '_' THEN d$ = d$&'_! 
10090 END IF 

10100 END IF 

10110 RETurn d$ 


10120 END DEFine Directory_Name$ 
10130 : 


10140 DEFine FuNction Drive_Name$ (filename$) 


10150 LOCal d$,ch 

10160 dg = !! 

10170 ch = '_' INSTR filename$ 

10180 IF ch > O THEN d$ = filename$(1 TO ch) 
10190 §=6(RETurn d$ 

10200 END DEFine Drive_Name$ 

10210 : 


10220 DEFine FuNetion Pure_Filename$ (filename$) 


10230 LOCal ch,d$ 

10240 ch = 

10250 dg = '!! 

10260 

10270 RETurn d$ 

10280 END DEFine Pure_Filename$ 
10290 : 


LEN (Drive_Name$(filename$) )+LEN(Directory_Name$(filename$) ) 


IF LEN(filename$) >» ch THEN d$ = filename$(ch+1 TO LEN(filename$) ) 


10300 DEFine FuNction Extension$ (filename$, separator$, maxlen) 


10310 LOCal ch,c,ext$,f$ 

10320 REMark maxlen is the maximum length of extension permitted 
10330 REMark usually '_' or '.' plus three characters 

10340 REMark separator$ is '_' (QDOS) or '.' (PC) 

10350 f$ = Pure_Filename$(filename$) : REMark remove drive+directory 
10360 ext$ = '' : REMark extension string 

10370 ch = LEN(f$)-maxlen+1 


Text 87 |{ PROGRAMMING 


QD 2003 £ 49.00 

£79.00 QD + QBasic £ 63.00 
Typset 94 £ 29.001] Qn + Qliberator + QBasic £ 104.00 

Fountext 94 £ 39.00 Qliberator £50.00 

2488 drivers £ 29.00}] Master Spy v3.3 £ 30.00 

Epson ESC/P2 drivers | QPTR £ 32.00 

Easyptr pts 1 & 2 v4 £ 41.50 

Text 87 Easyptr pt 3 (C library} £ 14.00 

High Colour || QMake £ 18.00 

Patch QMon /JMon £ 22.00 


: Basic Linker £ 22.00 
Available Now DISA3 £ 34.00 


£9.00 QMenu £ 16.00 


v1.02 


£ 41.50 


+ P&P 
22.00, (UK) £2.80, (BU) 23.00 (ROR 
| Beg xs SM sdie ton : {ROR} 


QDT is now vetsiadl 1.02 and 
updates can be pohtatned from Q 


QPC2 has is “beat updated to 


3.12 
SMSQ/E ‘is pe v 3.32 with 
many new enhancements, 

We are now supplying QPC2 on 
a CD ROM disk with the 
omanual in PDF format. 

QPAC2 is. now version 1.44 and 
is compliant with the new 

: HOME directory commands, 

a. Spring is coming and there are 

= more new things coming along 

with it. 


7 yPTR v4 


High abe support, Major re-write! E 
Full Program Pts 1&2 
£ 41.50 


Upgrade from any Version£27, 50 
beets Seldeihe Vv 310s 


QL Keyboard Membranes 
Available Now ! 


QPC 2 v3.32 P) £17.50 ea + PSE 
Now Only £ 42.00 ae 


now on CD ROM 


SMSQ/E 


Gold Card / Atari / QXL Version 
Aurora High Colour Included 


£ 27.00 


Version 3.12 out now! 


Aurora colour upgrade 
£ 13.00 


Get Cueshell for only £15.00 with any copy of SMSQ/E i 


Print to any printer from QPC2 


QPCPrint £ 27.50 | 


el +44 (0) 1273-386030 fax +44 (0) 1273-43050] 
Mobile +44 (0) 1836- -745501 


UTILITIES 


20 LOCKS a PORTSLADE, Qsup «£30.00 
E, SUSSEX, BN41 2LB. UK. Qspreed 2003, £51.00 
Hardware in Stock Now! Qlond/Qref £1 5.00 
is. ate “ 
Yad aserhardwaecaluy | acl £2200 
for details. QPAC 2 £ 42.00 
New Aurora boards in Aig : = sae 
stock! £28.00 : 


Sled 


( These programs are now } 


1 
MALE Hardware . 
WinkEd Second user items are are sometimes available fi 
QPAC i ‘ftom us, ~~ a 
Bes 2 Call for details. 
R'cyeld SuperGold Card € 110.00 
pecan Wel digi ES Recycled Gold Card £45.00 
Disk Mate 5 Recycled Aurora £ 65.00" 
Please send old master jf Qubide.. £ 45.00" 
disks and £1.60 Pig cover Qplane ©. £ 5.00 
foe e rl and copying & Recycled superHermes £ 65.00" 
Aurora cables £3.00 
_ | Aurorarom adaptor £3.00 
e | Arfa Braquet' £ 8.00 
s0¢ | MC plate £ 6,50 
508] New Aurora M/b £ 70.00 
update from v3.xx Free a : is Ney aoe Me 5 40:00 
date { 2 2 13.908 | Wo! inerva 
update from v1 £34.00) Qubide upgrades 
Return Master Disk ji to version 2.01 £ 8.00 
bade Omer ae ee - 


pein oa cos ot seule : 


The Knight Safe 3 
upgrades from previous versions 


Q-Count 
Pointer driven home accounting 


Post and Packing is included with Software Prices 
Unless Otherwise Stated. 


We accept payment by Visa, Mastercard, Maestro and Switch. We can also 
assept sterling cheques drawn on a UK bank or payment direct to our UK 
account at Natwest. Account: QBranch # 84534826 Sort Code 60-17-01. 


Route finding programme 
The Fractal Collection 


£35.00 


10380 IF ch « 1 THEN ch = 1 

10390 FOR ec = LEN(f$) TO ch STEP -1 
10400 IF f£$(c) = separator$ THEN 
10410 ext$ = f$(e TO LEN(f$)) 
10420 EXIT c¢ 

10430 END IF 

10440 END FOR c 

10450 RETurn ext$ 


10460 END DEFine Extension$ 
The four functions are as follows: 


DRIVE_NAME$ returns the drive name part of a 
filename (defined as the part up to and including 
the first _’ character in the filename). 


DIRECTORY_NAME$ uses the technique of open- 
ing a directory channel with FOP_DIR and using 
the Toolkit 2 FNAMES$ function to return the 
name of the directory part of the filename. 
FNAMES does not return the '_' character but our 
function does, as it usually makes it easier 


PURE_FILENAME$ strips off the directory and 
drive name, returning just the filename part. In our 
example above, WIN1_PROGS_MYPROG_EXE has a 
oure filename of MYPROG_EXE 


EXTENSION$ returns the filename extension, 
being defined as the part of the filename after 
the last separator. 

For example, WIN1_PROGS_MYPROG_EXE has an 
extension of '_EXE. This function lets us specify 
whether extension separator characters are 
QDOS-style '_' characters or PC-style ' .’ cha- 
racters. We can also specify how long 
extensions should be, to reduce the risk of 
confusion in programs which have underscores 
as part of their filenames, such as a program 
called my_first_program store in wini_progs_. In 
this case, that program does not have a filename 
extension as such, QDOS has no real knowledge 
of filename extensions as such. 


Examples: 

PRINT Pure_Filename$('winl_progs_myprog_exe') 
orints myprog_exe 

PRINT Drive_Name$('wini_progs_myprog_exe' ) 
prints wint_ 

PRINT Directory_Name$('wini_progs_myprog_exe') 
prints progs 

PRINT Extension$('winl_progs_myprog_exe','_',4) 
prints _exe 


Here is a short test program showing you how 
the routines should be used: 


100 CLS : CLS #0 

110 INPUT #0,'Full filename '; full$ 

120 PRINT 'Full filename = '; full$ 

130 PRINT 'Drive name ae Ee 
Drive_Name$(full$) 

140 PRINT 'Directory name = '; 
Directory_Name$(full$) 

150 PRINT 'Pure filename = '; 


Pure_Filename$(full$) 
160 PRINT 'Extension name = '; 
Extension$(full$, '_',4) 
170 STOP 


Now, let us progress to a short program to show 
the use of this little bit of code. Below is a simple 
copier program, able to copy files from one 
directory to another. 


100 CLS : CLS #0 

110 INPUT #0,'Copy from ';from$ 

120 INPUT #0,'Copy to 'sdest$ 

130 OPEN_NEW #3,ram1_temp 

140 DIR #3, from$ 

150 CLOSE #3 

160 drive$ = Drive_Name$(from$) 

170 OPEN_IN #3,rami_temp 

180 INPUT #3,t$ : REMark skip medium name 

190 INPUT #3,t$ : REMark medium capacity 

200 REPeat copying 

210 IF EOF(#3) = 1 THEN EXIT copying 

220 INPUT #3,f$ 

230 PRINT'Copying ';drive$&f$;' to '; 
dest$&Pure_Filename$(drive$&f$) 

240 COPY drive$&f$ TO dest$& 
Pure_Filename$(drive$&f$) 

250 END REPeat copying 

260 CLOSE #3 

270 DELETE rami_temp 

280 STOP 

290 : 


There are probably simpler ways of writing such 
a program, but it should serve to illustrate how to 
use the routines. The locations where files are 
copied from and copied to are entered in lines 
180 and 190 (ensure they end with a ‘_’ character 
of add lines just after them to check if the string 
ends with '_’ and if not add the character). 

Lines 130 to 150 sends a list of files to a 
temporary file called ‘rami_tempThese lines 
could really be shortened to just 130 DIR \ 
raml_temp, from$ on systems where DIR allows 
this form. 

Line 160 extracts the drive name, in case the 
‘from’ entry includes a directory name. 

Lines 180 and 190 ensure that the first two lines 
of a DIR listing are skipped - these contain the 
medium name and capacity. 

The loop then reads back all filenames from the 
list. 


Line 240 sorts out the names and does the 


copying. 
Let us suppose that the filenames are to be 
copied from WINI_PROGS_ to 


WINL-PROGRAMS-. 


"WIN PROGS_! 
'WINI_PROGRAMS_' 


from$ 
dest$ 


ott 


The listing output by DIR includes the directory 

names but not the drive name. 

240 COPY drive$&f$ TO dest$& 
Pure_Filename$(driveS$&f$) 


drive$ was extracted in line 160 so that we have 
just the root drive name to go with the filenames 
from the DIR listing. 

We combine the drive name and the filename 
from the DIR listing {the part of line 240 before 


Thanks to the hard work done by a number of 
people, its never been so easy to add decent 
sound to your programs as now. If you have a 
Qx0 or QPC2 you can use the SMSQ/E Sample 
Sound System (SSSS - shortened here to SSS, to 
encompass Qdos Classic) to play sound samples 
and even real music. This can make a big diffe- 
rence to the fun and usability of your programs. 


Here | present a few simple routines that you can 
merge into your own programs directly, or just 
take a look at, to get an idea of how easy it can 
be to produce your own. These routines take 
into account that you may want your programs 
also to be able to run on platforms that don't 
have the supporting hardware, in which case 
they fall back on the familiar BEEP 


All you need in addition to the platforms men- 
tioned (QPC2 must be V3.20 or later) are Wolf- 
gang Lenerz’es Soundfile toolkit, which you can 
download from the Internet (contact details be- 
low) and some sound samples. 

For distributable programs | prefer the Soundfile 
toolkit as it can be compiled in with the code, 
whether you use Turbo or Qlib. Simon Goodwin's 
sound device is more versatile, but needs to be 
loaded residentially at boot time or at least before 
starting your program. 


Sound samples are a different matter Until 
someone creates an online sound sample library, 
you will have to pinch them from other programs 


the TO ) to copy from, then we use the 

Pure_Filename$ function to strip the source 

drive and directory name to get the simole file- 

name, which is then added to the destination 

drive and directory to work out where to copy 

to 

Somewhat mind boggling until you get used to 

the concepts involved! 

This program could be extended to only copy 

files with given extensions by adding lines such 

as: 

125 INPUT #0,'Copy files with extension 
'sextn$ 

225 IF Extension$(f$,'_',LEN(extn$)) = 
extn$ THEN 

245 END IF 


These routines are ones you never realised you 
needed until you've started using them! 


(for example from the game D-Miner, available off 
my website) or record and/or convert your own. 
(How? Download Jonathan Hudson's Qdos port 
of SOX to convert standard wav files to the ub 
format, or search for and download a Windoze 
compatible version of SOX on the Internet and 
use that) 


Ok, so lets get our hands dirty. My comments 
normally describe the code block immediately 
above, unless otherwise stated: 


1 REMark $$asmb=wini_snd_sound_bin,0,10 
2 


If you want to compile the program with Qlib and 
include the soundfile toolkit with the code, you 
need this line. The corresponding Turbo directive 
1S: 


1 REMark %%winl_snd_sound_bin,0,10 
ae 


You don't need to compile a separate version for 
non-SSS platforms as, provided you don't call 
any of the procedures in the toolkit, it won't error. 
The routines shown here take care of that for 
yOu. 


3 rem Test for presence of Sampled Sound 
System 

4 TstSSS 

5 


One of the first things to do is to determine 
whether the SSS is present and set a switch 
accordingly. | use two global program switches 
relating to sound: 


1) ssspresent can be true of false depending on 
whether the SSS was detected or not. This 
switch is set inside the TstSSS procedure. 


2) sound is used by the sound subroutines to 
determine whether the user wants sound or not. 


sx$ = '_ub! : rem Sound file extension 
d$ = 'rami_snd_': rem Sound file folder 


CcoO~T ON 


Initialise some variables used in the sound 
routines. Better have them up front where they 
can be easily seen and altered, rather than 
buried somewhere deep inside your program. 


9 game = 0: win = 1: rem Some dummy game 
variables 

10 randomise date 

11s 


I've devised a very silly "game" to help illustrate 
usage. 


12 rem User input or config file determines 
sound on/off 

13 snd = YesNo('Do you want sound’) 

14 SetSound snd: rem Switch sound on/off 

15 print 'Ready to play' 

16 Ping 'ok': pause 50: rem allow time to 
display sound and text 

i ie 


Its always a good idea to give the user the 
choice of having sound or not. SetSound sets 
the global program sound switch to on or off. If 
sound is wanted, it also sets the switch to the 
best available sound. 

Finally Ping gives a confirming noise if sound is 
on (see below) 


18 rem Your program goes here. Eg.. 
19: 

20 cls 

21 rep main 

22 PlayGame 

23 if game = win then 

24 print 'You win :o)! 
25 Ping ‘win! 

26 else 

27 print 'You loose :-({' 
28 Burp ‘loose! 

29 endif 


30 if not YesNo("Another game"): exit main 


31 endrep main 
32 Ping 'bye! 
33: 


The main program loop simulates a game. If you 
"win’ It plays the ‘win_ub” sound sample, other- 
wise it plays the ‘loose_ub” sound sample. That's 
really all there is to it! The rest is just detail! 


Ping and Burp take a filename parameter which 
means you can re-use them to play different 
sound samples, but they fall back on only two 
kinds of beep: ‘Nice beep’ and ‘Bad beep’. But 
this is a simplification for the purposes of this 
demonstration. If you know how to be creative 
with BEEP you could do things differently and 
very much better The point is that you can follow 
any action with a sound, as shown. Every click on 
a button could produce a different sample sound 
and fall back on a different beep if you wish. 


Note: When storing sound samples in a library it 
is a good idea to group them and give them 
evocative names such as ‘quack’ or ‘gunshott’. 

However, when you use them in a program it is 
better to rename copies of them according to 
their function in the program. This makes the pro- 
gram logic clearer and also allows the user to re- 
place the default sounds with his own selection. 


34 defproc PlayGame 

35 rem Dummy game routine 
36 game = rnd(0 to 1) 

37 enddef PlayGame 

38: 


Well, that was your free game ;0) 


39 deffn YesNo(txt$) 

40 print txt$; ' <Y¥/m? '; 

41 if inkey$(-1) instr 'y' & chr$(10): print 
'¥Y': ret 1 

42 print 'N': ret 0 

43 enddef YesNo 

44: 


Here follow the sound routines: 


45 rem Sound routines 

46: 

47 defproc SetSound(s) 

48 if s then 

49 if ssspresent: sound = 2: else: sound = 1 
50 else 


51 sound = 0 

52 endif 

53 enddef SetSound 
5A: 


SetSound 0 turns the program sound off, while 
SetSound 1 turns sound on. It also determines 
the level of sound available to the program: either 
BEEP or SSS. Allit is is a logical switch in a wrap- 
per for convenience, as the option of changing 
the sound status should be available to the user 
at any time. 


55 defproc Ping(nm$) 

56 rem Nice sound 

57 if sound = 2 then 

58 if ftest(sd$ & nm$ & sx$) = 0 then 
59 killsound: soundfile sd$ & nm$ & sx$ 
60 else 

61 beep 2, 2 

62 endif 

63 else 

64 if sound: beep 2, 2 

65 endif 

66 enddef Ping 


68 defproc Burp(nm$) 

69 rem Bad sound 

70 if sound = 2 then 

71 if ftest(sd$ & nm$ & sx$) = 0 then 
72  killsound: soundfile sd$ & nm$ & sx$ 
73 else 

74 beep 999, 255 

75 endif 

76 else 

77 +%(if sound: beep 999, 255 

78 endif 

79 enddef Burp 


The logic of Ping and Burp is: 


If sound is off: do nothing 
If sound is on then 
If SSS available then 
lf the file exists: play sample sound 
in all other cases just beep 


81 defproce TstSSs 

82 loc adr 

83 rem GLOBal ssspresent 

84 rem Test for presence of Sampled Sound System 

85 rem VO.01 pjwitte 2005 

86: 

87 adr = alchp(26) 

88 poke_l adr + 00, hex("43fa0016"): 
rem lea.1 result,al 

89 poke_]l adr + 04, hex("26780070"): 
rem move.1 exv_i4,a3 

90 poke_] adr + 08, hex("0cab5353"): 
rem cmp.1 #sss.flag,-8(a3) 

91 poke_l adr + 12, hex("5353fff8") 

92 poke_l adr + 16, hex("57e90001"): 
rem seq 1(a1) 


93 poke_w adr + 20, hex("7000") 
rem moveq#0,d0 

94 poke_w adr + 22, hex("4e75") 
rem rts 

95 poke_w adr + 24, 0 : rem 
ds.w 1 

96 call adr 

97 ssspresent = peek_w(adr + 24) 

98 rechp adr 

99 enddef TstSSS 

100 : 


TstSSS is the only little awkwardness that re- 
mains, and hopefully it will one day be redundant: 
There is no easy and documented way offered 
by the OS of determining whether the Sampled 
Sound System is available or not, so we have to 
resort to a bit of jiggery-pokery. All this routine 
does 1s check whether it can find the SSS flag at 
the documented location just above the interrupt 
server, and set the ssspresent switch according- 


ly. 
Have fun! 


D-Miner can be found on my website, at 
Knoware: 
http://knoware.mysite.freeserve.com/index.html 


The soundfile toolkit can be found at Wolfgan 
Lenerzes website: 
http://www.scp-paulet-lenerz.com/14mljkl24/wolf/ 
download/ 


The Qdos version of Sox can be found at 
Jonathan Hudson's website, 
Daria: http://www.daria.co.uk/ 


Simon Goodwin's sound device and a collection 
of sound tools - including samples - can be 
found at Dilwyn Jones’es massive site: 
http://www.dilwyn.uk6.net/index.html 


Editor's comment: 

We will put the sound files and the listing on 
one of the next cover disks, assuming it is not a 
“motto” disk. Or maybe we can even produce a 
"Sound cover disk” - who knows? If you have 
contributions for it, please send them to us and 
we will see what we can do! 

To make it easier for you to obtain the sound 
files, they will also be available for download on 
the website QLTODAY.com - thank you very 
much, Bruce! 


Ds Shoestring Linux ACCESS (continued from Vol. 10 Iss.1 pg) 


5c. Installation 

In the last part we were left staring at the " Command (mfor help): prompt of atari-fdisk In the 
meantime, Derek Stewart's article in the previous QL Today (Vol10.lss.2.p.34) explained some things, 
much to my happiness as | can now reduce the size of the article! (Slacker! - Ed). 

Assuming you already have pressed" p’ your screen should look something like figure 1. 


* B..28 
* 3445729 34 
% ZAB97029 


doin; for help? on 


Figure 1 - atari-fdisk partition list 


You see in that screen that | already have Linux partitions. Assume that there is none for your 
purposes and give "n’ and ENTER to the prompt. You will be presented with information on the free 
space on the disk as well as a prompt for the first sector of the new partition. Press ENTER there as it 
assumes the first available. 
Then either give the last sector of the partition, the size in Megabytes or Kilobytes (a number 
preceded by an addition sign” + and followed by a capital K or a capital M!@ +100M -or- +102400kK) 
or by pressing ENTER the default size given by atari-fdisk (figure 2). In my case the newest 
partition was number 5 (if you examine the previous partitions 5 and 4 from figure 1 you will see a gap 
in the sector numbers. That gap corresponds to empty space which is what partition 5 filled up. 


c 


28, aft 11337728): +1 HaM 


Figure 2 - New partition creation 
lf you now type p again your screen will look something like figure 3. 


Figure 3 - changed partition list 


since you are making a brand new installation, you will obviously have only SMSQ/e partitions 
(denoted by the type QWA), so you will need to make one or more Linux partitions - Linux doesn't 
mind too much about the size; but make sure you make a smaller one that will be used as a SWAP 
This is where Linux “spills out” memory contents that are not being used if the physical memory gets 
full. The larger that is, the more programs Linux can load without crashing. Make sure this is set to at 
least 128 Mb. Mind you though that in small footprint systems (like the Q40 -not the Q40i) where 
memory is not abundant, the more applications you allow Linux to run, the slower the machine will be 
response-wise. To create the swap partition, create the partition as previously, then on the prompt, 
type t to change its type from the default LNX and enter SWP (for Swap). In any case, when you are 
done, enter w and press ENTER to exit and save your changes. 


TF Services 


AUK 4-way trailing socket designed to switch off 
computer peripherals automatically when the 
computer is switched off, or (in the case of an ATX 
computer) when it auto-powers down. Compswitch 
has one control socket, and three switched sockets. 
Can be used with lights/hifiémonitors—ie a QL 
monitor can be used as a switch control. 


Cost £24 
superHermes 


A major hardware upgrade for the QL 
All Hermes features (working serl/2 at 19200, 
independent baud rates/de-bounced keyboard/ 
keyclick) IBM AT kbd I/F // HIGH SPEED RS232 at 
57600// serial mouse port and 2 other RS232 inputs// 
3 VO lines // EEPROM 
Cost (including manual/software) 
IBM AT UK layout Keyboard 
Serial mouse 
Capslock/scrollock LED .... 
Keyboard or mouse lead w £3 (£3.50/£3.50) 
High speed serial (ser3} lead £4 (£4.50/£4.50) 


Hermes available for £25 (£26/£27) Working ser 1/2 and 
independent input, debounced keyboard. 


SuperHermes LITE: All Hermes features (see 
above) + an IBM AT keyboard interface only. 
Cost (incl keyboard lead) £53 (£54/£55) 


OL REPAIRS (UK only) 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thom-EMI rig and ROM software. 


£27 incl 6 month guarantee 


£90 (£92/£93) 

£11 (£13/£15) 

£8 (£8.50/£9) 

£1 (£1.50/£1.50) 


Minerva 


The ORIGINAL system operating system upgrade 
OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system autoboot on reset of power 
failure’ Multiple Basic/ faster scheduler- graphics (within 
10% of lightning) - string handling’ WHEN ERROR/ 2nd 
screen/ TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split OUTPUT baud rates (+ Hermes) 

& built in Multibasic. 
First upgrade free. Otherwise send £3 (+£5 for manual if requd). 
Send disk plus SAE or two IRCs 


MKI...£40 (£41/£43) MKII...£65 (£66/£67) 


MINERVA RTC (MKID) + battery for 256 bytes ram. 
CRASHPROOF clock & PC bus for interfacing. Can 
autoboot from battery backedram. Quick start-up. 


— LL RomDisq 
Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage - 
it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 

Think of it - you could filly boot an expanded QL, 
including all drivers/SMSQ ete off RomDisq at hard 
disk speed with only a memory expansion needed. 


2 mbytes RomDisq. £39 (£40/£41) 

4mbytes RomDisq. £65(£66/ £67) 

8 mbytes RomDisq. £98 (£99/£100) 
Aurora adaptor. £3 (£3.50/£4) 


eens | fd 0) 
A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Card/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
outside) & QL motherboard in tower case. Specify ROM 
facing IN towards boards, or OUT towards back of case. 


£34 (£35/£36) 


Connects to Minerva MKII and any Philips PC bus 


Power Driver Interface 16 VO lines with 12 of these usedto 
control 8 current carrying outputs (source and sink capable) 
2. amp (for 8 relays, small motors) £40 (£43/£44) 
4 amp total (for motors etc} 
4 power 
£25 (£28/£29) 
Parallel_Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required £25 (£27/£28) 
Analogue Interface Gives cight 8 bit analogue to digital 
inputs (ADC) and two § bit digital to analogue outputs 
(DAC). Used for temp measurements, sound sampling (to 
£30 (£31/£32) 
- £10 (£10.50/£11) 
. £10 (£10.50/£11) 
£2 (£2.50/£3) 
£2 (£2.50/£3) 


Connector for four temp probes.... 
Data sheets 


OL SPARES 


Keyboard membrane no longer on sale 
£3 (£3.50/£4 
- £3 (43.50/54 


Circuit diagrams.. 
£8 (£8.50/£9 


68068 cpu or 8049 IPC... 

8301/8302 or JM ROM or serial lead £10 (£10.50/£11 

Power supply (sea mail overseas). £12 (£19/£23 
Other components (sockets etc) also available 


Prices include postage and packing (Airmail where applicable) Prices are: UK (Europe /Rest of world). Payment by cheque drawn on bank with UK 


address,/postal order or CASH! | can no longer accept card payments as UK only does PDQ transaction. SAE or [RC for full list and details 


22 Feb 13 


29 Longfield Road, TRING, Herts, HP23 4DG 


Tel: +44 (0) 1442-828254 


Fax/BBS;: +44 (0) 1442-828255 


tony@firshman.co.uk —http://www.firshman.co.uk 


Then type shutdown -r now and press ENTER. At the prompt, just press ENTER and wait until Linux 
signals you that it is time to reset. 


Next, insert your Linux CD and start Linux by giving: 
EX wini_lxx; '-k wini_vmlinux -m 32 -- root=/dev/hdX parport=0x278,0x378' 


Where -m 32 could be -m 64 etc. depending on your memory size and /dev/hdx is the drive 
descriptor corresponding to your CD (ie in my machine it is /dev/hdb). As previously mentioned the 
parport option should be set to only one or two ports depending on your Multi 1/O card. 


Once, the Penguin shows and Linux rants about the machine etc. you will be prompted to login. Login 
as root and then type xinstall and press ENTER. 

The installation program will aopear and you should follow the simple but easy to use install program. 
Once it gets to the packages installation, get up from your desk, make a coffee (although a four 
course meal is more accurate!) as it will take a long time (1 hour + on a Q60 / 3+ hours on a Q40) 
before that step is finished. 

After the packages have been installed you will be presented with the final screen where you can 
make configuration changes. Make SURE you enable the network, otherwise the editing involved will 
make the bravest, shy! 

Once you exit and shutdown Linux, restart your QxO and then start Linux again, with the same 
command as before but this time substituting X for your Hard and partition that Linux was installed on. 
In my case this Is: 

EX wint_lxx; '-k winl vmlinux -m 32 -- root=/dev/hda4 parport=0x278,0x378'! 


Once Linux has started, log in as root and get ready for the configuration. 


5d. Setup for a LAN 
1. Introduction 
There are two main types of LAN connections; Static and Dynamic, each of which can be setup in 
two ways: Permanently and Per Session: As we want to simplify everything, we will look into the 
per session way as although it has to be repeated, every time that Linux boots, it is a lot easier to 
set up. Additionally, you wouldn't want everything on a silver platter now would you? (YES WE 
WOULD - Ed.). Okay, okay! You convinced me! Without further ado let's go to: 


2, Ethernet Card Setup 

Before we continue, we will need to make sure that your Ethernet card is properly set up and that 
Linux recognises it. If your machine was setup by D&D that should be no problem - The card 
should be at 0x300, IRQ: 5- however if you got one off of some bargain bin, computer store or even, 
eBay, chances are that it is setup for I/O address 0x300, IRQ: 3 which is the NE2000 standard. Now, 
normally there's nothing wrong with IRQ 3 as it is a shareable interrupt (shareable with Ser2 or 
COM2), however, | have found many cases that that won't work under SMSQ/e properly for reasons 
that | didn't even bother to investigate (we know you are lazy - Ed). It is best, therefore to set it up 
for IRQ 5 and that should create NO problems whatsoever. In order to set it up, you will need to 
modify a configuration file, however Linux/Unix text editors tend to have a myriad of not-so-user 
friendly key combinations. 
Now, thanks to the foresight of Richard Zidlicky, there's an easier solution: Midnight Commander 
Midnight Commander is a clone of Norton Commander on DOS. For DOS novices or people who 
have never used a PC, your QL equivalent is Dilwyn Jones’ Q-Trans, which is also a quasi clone of 
Norton Commander. Midnight Commander (figure 4), provides not only for fast navigation in the 
typical vast Unix tree, but also a convenient file editor and viewer among other things. 


To start Midnight Commander, type mc and press ENTER. 


You navigate using the cursor keys, switch panels with TAB, select/deselect with INS and perform 
actions with ENTER (to change directories or launch a file). To perform all other actions, use the 
function keys listed on the bottom (The F is ommited). F9 calls the pull down menu. 


The first directory that you will see 
listed is the root user's home direc- 
tory (no need to elaborate on that as 
this isn't a Linux/Unix tutorial). Find 
the entry '..’ (Iwo periods signify 
up one directory in the structure), 
press ENTER and you will be in the 
root directory. Next find the /ete 
directory entry, move the highlighted 
bar above it and press ENTER. 
Next, locate the modules.confg40 
file. Highlight it and press F4. That will 
take you to the editor 

Locate the entry reading: 

options ne io=0x300 irq=3 


ea 7 
Figure 4 - Midnight commander 
if the line reads instead: 

options ne io=0x300 irq=5 


then you are fine and you can quit both the editor and Midnight Commander and proceed to the 
next step, otherwise change the irq=3 to irq=5 (provided that that is the IRQ you set your card 
to). Press F10 and select Yes when asked. Quit Midnight Commander with F10. 

Although it is possible to make Linux to read the change in configuration immediately, we will go the 
easiest route and just reboot the machine (What only Windows should do that?). Reboot by pressing 
CTRL-ALT-DEL (That effectively issues a shutdown -r now command, thanks to Richard and shuts 
Linux down cleanly). 

Restart Linux as before and you are ready to... 


3. Setup for DCHP 

DHCP stands for "Dynamic Host Configuration Protocol’, a protocol for assigning dynamic IP 
addresses to devices on a network. With dynamic addressing, a device can have a different IP 
address every time it connects to the network. DHCP also supports a mix of static and dynamic IP 
addresses. In short, you do not have to either assign an IP address -or- to manually change it if the 
case arises. The network software, probes the network for DHCP broadcasts and responds to 
them. In turn a DHCP server will assign an IP address from the “pool” of available addresses to it. 


To setup DHCP do the following: 


a. Shutdown the network by issuing /ete/re.d/init.d/network stop 
b. Using Midnight Commander (see above), edit the file 
/ete/sysconfig/network-scripts/ifefg-eth0d to be as follows: 


DEVICE=eth0O 
USERCTL=no 
ONBOOT=yes 
BOOTPROTO=dhep 
BROADCAST= 
NETWORK= 
NETMASK= 
IPADDR= 


c. Save this and next edit the file /etc/sysconfig/network to use DHCP 
This should read: 


NETWORKING=yes 
HOSTNAME= 
FORWARD_IPV4=yes 
GATEWAYDEV= 
GATEWAY= 


d. Restart the network to probe the DHCP server for your network settings with the command 
/ete/re.d/init.d/network restart 

e. Verify your network settings with the commands /sbin/ifconfig (figure 5) to make sure you 
have received an IP address from the DHCP server and /sbin/route (figure 6) to see if your 
gateway is properly setup. 


(roct@qd0 /J4 /shin/ifconf ig | , 

etho Link encaps! Ethernet Hbladdr 00300:B4333:30254 hee See 
inet -acdr #192 -166,254,115  Boast;299,255,295.250 _Hesk:255.295. 205.0 pesca Gateway Genmask Flags Heenls et Use Iface 
UP BROADCAST RUNNING FULTICAST MTU:i500° Metrics’ 192.168 254. 8 : 255,255.255.0 U 0 atho 
RX packets?126 errors!0 droppeds0 overruns:0 frame;0 is Bead eeoe 

pan 09 298,0,0.0 u 4 8 0 lo 

TX packets:112 errors:0 dropped? overruns:0 carrier:0 4a 168.254.254 9.0/0.0 u O8 ry 0 athd 
collisions?) txqueuelen:100 40408 sae! ht . 
RX bytes:58995 (57.6 Kb) TX bytes:11785 (11.4 Kb) root 


Interrupt:5 Base address :0x300 . 
Figure 6 {above} - route output 

le Link encap:Local Leopbac 

inet sddr2427.0.0,4 Mask: 255.0.0.0 

UP LOGPBACK RUNNING HTU316436 Metrics 

RX packets?0 errors:0 dropped:0 overruns:0 Framez0 

TX packets?0 errors:6 dropped GO overruns!0 carrier td 

collisions:@ txquevelen: 

RX bytest@ (0.0 b} IX nee 0 60.9 by 


essa Figure 5 (left) - ifconfig output 

f, Ping the gateway and a few other computers on the network to verify your connection by issuing 
ping 192.168.254.254 (replace the IP address with your gateway’s IP address). Note that pinging 
will not stop until Ctrl-C is pressed. 


4. Setup for a Static Address 

A static address stays the same all the time. This is especially good if you want for example to run 
a Web Server on your Q40 and you want to redirect HTTP requests to the Q40 and say FTP 
requests for your Amiga (See | don't even mention Windows!). That Is a lot easier to perform if the 
machine is on a fixed address. The downside to that is that you will have to provide Linux with more 
information than just the address; you will need to also provide the Netmask and Gateway for your 
network. This is usually either your router or a more advanced ADSL or Cable modem. Q40 Linux is 
perfectly capable of acting as one as well, however you will need at least two network cards (which 
also means that you will need some kind of ISA extender to be able to plug more cards). So we 
skip this information instead and go directly to the configuration. 

There are two ways to configure for a static address: 


a. By session 
To configure by session do the following: 


e Set the IP address and network mask: /sbin/ifconfig -a ethO 192.168.254.233 netmask 
255.255.255.0 
(This example gives the machine the IP address 192.168.254.233, but you can use any 
combination of |P/netmask that will work with your network. This information will be available 
usually from your router's manual) 

e Verify the settings with /sbin/ifconfig ethO 

e Add the default gateway (in my case): /sbin/route add default gw 192.168.254.254 (Replace 
192.168.254.254 with your gateway address) 

e Verify the gateway setting by issuing the following command: /sbin/route. The line beginning 
with default should have your gateway under the gateway column. 


b. Permanently 
To configure it once and for all do the following: 


e Edit the file /etc/sysconfig/network-scripts/ifefg-eth0 to look like the following (replace 
with your network numbers). 


DEVICE=ethO 

USERCTL=no 

ONBOOT=yes 

BOOTPROTO=none 
BROADCAST=192.168.254.254 
NETWORK=192.168.254.0 
NETMASK=255.255.255.0 
IPADDR=192.168.254.253 


e and the file /ete/sysconfig/network fo look like the following {replace with your network 
numbers and hostname) 


NETWORKING=yes 
HOSTNAME=q40. home. dokos-gr. net 
FORWARD_IPV4=yes 

GATEWAYDEV= 
GATEWAY=192.168.254.254 


c. To verify both types of configuration, ping your gateway and a few other computers on the 
network to verify your settings are correct by issuing ping 192.168.254.254 (replace the IP 
address with your gateway’s IP address). Note that pinging will not stop until Ctrl-C is pressed. 


5e. Setup for Cable/DSL 
1. Introduction 
Cable/DSL connections should be generally considered LAN connections as mentioned above, 
however there are some differences as not all Cable and DSL modems act as straight routers/ 
bridges. Some of them utilise a protocol known as PPPoE (Point-To-Point-Protoco! over Ethernet), 
which essentially is the same as your run-of-the-mill dial up connection but utilising Ethernet as the 
transmission channel. 
2. Regular connections 
If you have a ‘regular’ Cable or DSL modem and assuming that you have no separate Broadband 
router, then you should see 5d.3 above and particularly the DHCP setup, as that is the protocol that 
Cable and DSL modems utilise to connect you to the Internet. Once DHCP is setup, then the mo- 
dem through its built-in DHCP server will setup your machine and you will be ready to go. If you on 
the other hand you have a broadband router/switch, then you should read its documentation and set 
up your connection either as DHCP -or- Static according to the router manufacturer's instructions. 
3. PPPoE connections 
PPPOE is trickier as it requires a special program run on the machine akin to a dial-up dialer (as we 
will see soon), however, most of modern broadband routers and modems, do provide their own 
inbuilt one. In such a case you do not have to run a program on your Qx0 but you WILL have to 
setup your modem. 
Below, we will examine all cases (although not ALL possibilities as they depend on each 
manufacturer) 
a. PPPoE on modem or broadband router 
First you will have to read your modem's 
or router's manual. This will give you the 
fixed IP address where your modem’s or | — 
broadband router's configuration page is Seiler aacis | Wehie | Bo ee 
usually located (say 192.168.1.2 as it is the Re eee 
case for my Westell ADSL modem o oe ' 
192.168.254.254 where my Siemens se PPPOE Authentication 
Speedstream has its own) =. 
Setup your machine as per the instruc: @ 
tions for LAN with static IP address in the ¢ eee = = 
same network as the router/modem and Figure 7 - Configuration of Router via Browser 
directly connect to it via a browser -figure 7; 
see internet access below- (or telnet if your modem’s web page won't work with the browsers 
provided with Shoestring Linux -or- if it only provides you with a telnet interface). Then, enter your 
account's username and password, as provided by your [SPand you are all set. 
b. PPPoE software on your Qx0 
In case, that your modem is older, you will need to run software on your Qx0 to connect to it. There 
are two ways to do that: Completely manual and semi-automatic. 
1. Manual Setup 
In order to do that, fire up Midnight Commander again and go to /ete/ppp. There, edit the file 
pppoe.conf to conform to the settings provided by your ISP (figure 8). Make sure you add the 
username required to connect to your adsl/cable account. 


Then edit the file pap-secrets and add there as well 
the username (and this time also password) for your 
account (figure 9). 
Finally type adsl-start and your ads! connection 
will start. Verify your settings with ifconfig and 
route as before. adsl-stop will sever the connec- 
tion and adsil-status will show you the status. 


of pppd.anlue 


2. Semi-automatic setup 

There is an additional script which can simplify your 
life when it comes to PPPoE connections. That Is 
adsl-setup which will ask you a few questions and 
then modify the appropriate configuration files for 
you. As with 1 above, you will need to issue an 
adsl-start command to start the connection and 
adsl-stop to stop it. 


5f. Setup for Dialup 
1. Introduction 
Dialup connections are by far the most common, 
although they are quickly being pushed aside from 
ever-diminishing prices of Cable and xDSL. Most 
dial-up connections these days are of the PPP type, sie gia 
which is the type that we will concentrate on. Figure 9 - pap-secrets file 


(pasword erased) 


2. Verify your modem’s port and device 

Before i Start, you will need to know your modem port and device. For serial ports, Linux starts 

counting from 0, so the port that your modem is connected should be in the range of /dew/ttysx 

where x=0 to 4 (There are many more serial ports supported under Linux, however due to the 
particularities of the QxO hardware, it is unlikely that you will ever have more than 4 installed. 

Additionally there's another device called /dev/modem. This is a symbolic link to one of the serial 

ports on Shoestring Linux and it is there for your benefit. as it is always easier to recognise the 

word modem ;-) (Plus programs may use it directly} 

| recommend, using port 0 (serl_ on QDOS) as it is always easier unless you install an internal ISA 

modem. If that is the case, first make sure that: 

e Your modem is NOT a Winmodem (Winmodems require Windows to run) 

e |f your modem is Plug and Play, that it also has a ‘jumpered’ mode where you can set up its 
settings manually. Although pnp support is rather good in Shoestring Linux, not everything | have 
tried worked 

e Setup your modem as ser4_ (COM4 on the PC) I/O port 2E8, IRQ: 3. Other settings are possible 
but that will work for sure. 


Assuming now that you have an | 
external modem on seri_ {ttySO}, @ 
you can set up your connection and | 
subsequently connect to the Internet, § 
manually, seml-manually using § 
wvdial or using the more elaborate § 
and X-based netefg We however § 
due to its simplicity, well use netefg 


3. Setting up 

You will need to start the X-Windows 
GUI (Although that is not completely 
accurate as it is NOT the GUI but rather the framework upon a GUI is based) with startx and 
ENTER. 


Figure 10 - IceWM Window Uonaces ‘ead to run netcig 
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' Once the icewm (that’s the default GUI) is loaded 
{ (figure 10) is loaded, go to the open terminal 
window and type netefg and ENTER 
Once this is loaded, go to ‘Interfaces’, (figure 11) 
click on the pppO to select it and click on the 
Edit button below 
Next the ‘Create a new Internet Connection’ 
dialog will pop-up (figure 12). Clicking ‘Next’. if 
you haven't setup a modem yet (which you 
haven't), will take you through the steps of find- 
ing and configuring your modem (figures 13 and 
1. 14) 
/ Once the modem has been setup, you will be 
ss Coa ~ asked to enter the name and phone number of 
Figure it netcfg ‘interfaces fab your account (figure 15). Refer to your ISP's in- 
structions for the appropriate data. When you are done. click on ‘Next’. 
Consecutively, enter your username and password (figure 16) and click ‘Next’ 
Once, this too Is done, you will be shown the new account that you created (figure 17). 


Clicking “Finish” will commit the account information to the configuration files, thus making the 
account a part of your setup. You will then be presented with a list of the available dial up 
connections (figure 18). Clicking ‘Close’ will take you back to the first netct g screen. 

To connect to the Internet, you can either bring up 
netcfg, select the pppO connection and click 
‘Activate’ (figure 19), or from the terminal, type ifup 
pppd (ifdown ppp0 will hang up the modem and 
close the connection) 


This dialog will help you set up a new Internet Connection. 


You can nit cancet at any point to step, 


Figure 12 - Create a new Internet Connection dialog 


- Figure 15 -'ISP Phone number and Name dialog 


‘You have selected the following information: 
Account name: Infobahin 


User name: marienem 
Prone number: 1,724 4036100 


Press "Finish" to create this account. 


Figure 18 (above) - ‘Dial up Connections’ dialog 


Figure 19 fright) - netcfg ‘Interfaces screen 
with Active ppp connection 


5g. Using the connection 

Unlike the previous parts of the series due to the quantity of programs available to Linux for Internet 
access | will not show you configuration options etc. Instead | will point you to a few of these programs 
and how to start them. Once you become comfortable with these you can explore the documentation 
and installed packages of Qx0 Linux to see what else is available to you. 

Let's assume that your connection is up and running. Then it’s time for.. 


1. Browsing 

As with almost everything in 
Linux, browsing can be done in 
text or graphic mode. By default 
there are four browsers available 
on Shoestring Linux (g is for gra- 
phical, t is for text-mode): Net- 
scape (g), Dilo (g) Lynx (i) ad = 
Links (t) {a more user-friendlier | Coli (tal fom) aha | 
Lynx clone). | elm te Mn stron me ae 
To start Netscape or Dillo, you ae mya tyre 
will need to be in an X based GUI | gens cies toe 52 eae 
or Desktop (Gnome -one of the © ooet 
best desktops in my humble 
opinion: is included with Shoestring Linux). Fire it up with startx (See previously on dial-up con- 
figuration). Then for Netscape, either click on the Netscape “Lighthouse” icon next to the IceWM 
start button (bottom left of the screen), via the “IceWM » Netscape’ entry, the ‘IceWM > Applications » 
WWW Browsers > Netscape’ entry, or. finally by typing netseape and ENTER on your X- Terminal. 
To start Dillo, you should go to an X-Terminal type dillo and press ENTER 

For Lynx (and Links) you can either be in a GUI, or your console. Type lynx and press ENTER (rest 
of instructions are as per the previous two article parts). Links can be started by typing links and 
pressing ENTER. Esc will bring up the menu (it is pretty self-explanatory from then on) 

Figure 20 shows IceWM running all four programs at once. 


ation of nissing files, 
3) ied “Teelian version of the homepage, (Thanks to 


loved the homepage to its own subdone: 
Added Dutch version of the homepage, Thanks to Marco 


C4) Added Spanish version of the horepage, (Thanks to 
Javier Guerra) 


Stilt ta dor 

* Create irdous instal ler 

west, ual x deve loprents (ie Hidi L935) 
anual and front 

t 


aro (Preferennes! files 


follow a links Left to go back, 
arch (delotejshistory list 


lifrootite40 natwork: 


oe ORC Se butt 
“Figure 20 - Tease Dillo, Lynx and hs 


2. Email ae 
Similarly to the browsers, email . 
clients are also abundant in Linux. & 
For that reason | will only mention 
Sylpheed - a full featured graphical 
email and news client that works 
very well. There are two ways of 
starting Sylpheed: If you are in 
IceWM click on the little envelope 
article at the bottom right of your 
screen, or go to a terminal, type 
sylpheed and press ENTER (fig. 21). 


37h iP 

One of the easiest to use FTP clients 
for Q4Q Linux is gFTP {as a matter of 
fact, this article is uploaded using 
gFTP!), As with Syloheed, it too requires 
X. Run if, by going to an X-terminal, 
typing gftp and pressing ENTER (fi 
gure 22} Another (and the de-facto - 
standard) of course is ftp {t) which you : 
canrun by typing ftpat the console 


4, News : 
For news, there are two main packages: «# 
Sylpheed (mentioned above) and Pan. To 

start Pan, type pan and press ENTER at .,...- 
your X-terminal. (Figure 23). Additionally . 
you can use pine (t) and x-emacs for , 
news. 


5. Telnet 
To start telnet, go to an X-Terminal or | 
the console, type telnet and ENTER. | 
You will be presented with the telnet 
prompt. Type help for help on telnet's == aoe 
commands : 


Figure 23 Pan reading comp.sys.sinclair 


6. Conclusion & Author’s Disclaimer 

This part of the series is by no means a Linux tutorial, What it is, is a small attempt to helo Qx0 users 
navigate the complex world of Shoestring Linux, as to facilitate the exploitation of their machine's 
many abilities. Moreover, the configuration settings and commands are what worked for me. They may 
not work for you in exactly the same way, as you may have done something different with your 
installation or if you may have a different version of Linux {ie Q40 Linux). As you may have noticed 
(sic!) the programs did not get much attention by means of providing details on how to operate them. 
The reason for that is that most of them (at least the GUI based ones) provide extensive help files. | 
can go back and revisit specific ones in later articles if readers so wish. Just let the Editor know and 
we'll see what we can do! 


This article concludes the series as it stands currently. Hopefully in the next issue, | will be able to 
bring some new and exciting new developments on the Net on the QL front. Keep your fingers 
crossed! 


Oh and one more thing: | have received messages, letting me know that readers could not find the 
software (For the second time} on my website. This sadly was true but it has now been corrected. For 
some reason my Windoze ftp program did not transfer them properly. gFTP did that on my Q40. (The 
moral? Always trust QL hardware!) 
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Elsewhere in this issue of QL Today George Gwilt 
writes about using the QL to demonstrate a lec- 
ture. Those readers who were fortunate enough to 
be at QL is 21 saw this in practice, when George 
demonstrated his screen snatcher programs. 
These programs, the SVSCR suite, have been 
around for over three years, but are relatively 
unknown. As far as | know this is the first review 
of them. The suite consists of four programs writ- 
ten in Turbo PTR. To run the programs you will 
have to have a recent version of the Turbo Toolkit 
(V. 3.32 or later) installed on your machine. 
GSV_task is the mother program that sits dis- 
creetly in the background waiting for a signal that 
you want to save part of the screen. 
SVSCR_task works in conjunction with 
GSV_task and does the actual screen saving. 
PR2WIN_task allows you to view the saved 
partial screens and to change their size or distort 
them. 

PSA2PAT_task converts a partially saved screen 
into a sprite or pattern. 


GSV__task and SVSCR__task 
GSV_task and SVSCR_task work in conjunction 
with one another, and thus GSV_task needs to 
know where to find SVSCR_task. It is the only 
one of the four programs to have a configuration 
block. This has four items - the key combination 
to save a screen; the key combination to exit the 
program; the output file name of a saved screen; 
and the directory for the program SVSCR_task. 
You can also modify the default items at run time 
by starting the program with parameters. 
GSV_task sits in the background until you press 
the screen save key combination, which, by de- 
fault is SHIFT/TAB. When you do this the program 
SVSCR_task is loaded and a rectangle appears 
on the screen. You can move this using the cur- 
sor keys or if you are a speed fanatic, CTRL + 
cursor. To modify the size of the rectangle you 
use ALT + cursor or if you are impatient ALT + 
CTRL + cursor When you have the position and 
size you want, you press ENTER to save it. By 
default the saved file is raml_scl_psa. If you 
save a second partial screen this will be 
raml_sc2_psa. 

some years ago Phil Jones wrote a program for 
saving partial screens called graBIT and, of the 
two, | find George's program the easier to use 
because it gives a better view of the portion of 


the screen you wish to save. However the ad- 
vantage of graBlT is that its screens are saved in 
-pic format, giving greater compatibility with 
other programs, whereas SVSCR screens are 
Saved in _psa format. 

Until George sent us some screens saved in 
_psa format for publication in QL-Today, | knew 
nothing of the difference between _psa and _pic 
screens, although both are detailed in the QPTR 
manual. 
The _pic format has become the standard format 
for saving screens that are not the standard 512 
X 256 size. Prior to the screen information there 
is a 10 byte header. This consists of a flag identi- 
fying it as a _pic file, x and y sizes in pixels, line 
length in bytes and the mode flag. 

A _psa file is the same as a _pic file with the 
exception that the header is 12 bytes instead of 
10 bytes. The extra two bytes, at the start of the 
file, are spare for the programmer's own use, 

It is fairly easy to write a SuperBasic program to 
strip off the first two bytes of a _psa file to con- 
vert it into _pic. 

Although SVSCR_task usually works in conjunc- 
tion with GSV_task it can be used independently 
if you already have some saved screens on file. 


PR2WIN__task 

The SVSCR programs are not just screen 
snatchers, but also screen manipulators. 
PR2WIN_task looks for _psa files in ram1_ and 
displays them one by one. The displayed partial 
screen can be resized and distorted horizontally, 
vertically or spherically, 

Partial screens can be moved and resized using 
the cursor and CTRL + cursor keys as in 
SVSCR_task. The resized picture can be re- 
stored to the same proportions as the original on 
pressing F2. 

If you press F3 a window is opened allowing 
distortion. 

When you have finished manipulating an image 
you can press ENTER, and, if the image has been 
modified, it is saved to ram1_ with a slightly diffe- 
rent file name from the original. When you have 
finished modifying and viewing all the files they 
are printed to the screen. In this way you could 
design a montage made of several different par- 
tial screens. 

PR2WIN is not fully functional on all systems and 


QPC2 is one of the least functional. All you can 
do in QPC2 is move a partial screen. There is a 
reason for this. Until recently George has done 
his QL development on a Q60, which has a 
68020 processor whereas QPC2 emulates the 
68000 processor. 

in the manual George provides a 
useful summary of what can be 
done on which machine. Moving 
can be done on most machines. 
Resizing requires a 68020 pro- 
cessor and is possible with a 
Gold Card, QXL, Q40 or Q60. 
Distorting requires an FPU and 
should work with Q40, Q60 and 
some QxXLs. 

As my main QL platform is 
QPC2 | was unable to test this 
program extensively. My at- 
tempts to run the SVSCR pro- 
grams on my JM and Minerva 
black boxes ended in failure, 
although all ran perfectly on a 
Gold Card version of SMSQ/E. | 
should add that | had to take my 
black boxes out of a lengthy 
retirement and both are not only elderly but also 
infirm. Both refused to load the latest version of 
the Turbo Toolkit with an error message ‘not 
implemented’. 


PSA2PAT__task 
The final program in this 
suite is PSA2PAT which 
allows you to convert a 
partial screen into a solid 
sprite, a transparent sprite 
or a pattern. The sprite 
has to be rectangular, but 
if the transparent option is 
chosen all black portions 
f the image will be invi- 
ble. There is also a re- 
triction on the sprite size. 
size multiplied by Y size 
must be no larger than 
4092. 
The program is simple to 

use. First you are asked for the input file; then the 
output file and finally if you want to save the 
sprite as solid, transparent or a pattern. 

Those readers who were at QL is 21 will remem- 
ber how George illustrated this program by mak- 
ing a sprite from Tony Firshman’s head that he 
had saved from a colour photo. 


KAYO 


Most of us who source sprites from PC material 
probably use Wolfgang Lenerz’s program BMP2- 
SPRT but PSA2PAT could be a useful alternative. 
You could for example display a digital camera 
image in photon, save the part of the photo you 
want as a sprite and then convert using PSA2PAT. 


@ Fig. 1 


| was hoping to illustrate the SVSCR suite by 
examples of resized partial screens, but for the 
reasons given above this was not possible. 
Instead | displayed a jog image using photon. Fig. 
1 shows this image with the save area rectangle 
around the inn sign. Fig. 2 is a montage of par- 
tially saved areas of the main photo. 


The SVSCR suite is probably of more interest to 
the specialists than the average QL user, but it is 
worth looking at. The programs can be downloa- 
ded from the SQLUG site: 

www.jms1.supanet.com 

As an added bonus you can also download the 
source code. 


BIKE is a listing which Steve sent together with CONIC - published in an earlier issue of the last 
volume. It is a vector graphics demonstration. | must admit that | lost track of Steve's disk when | 
moved the office from the old address to the new one. Sorry about that - Editor. 


110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
330 
540 
550 
560 
5°70 
580 
590 
600 


REMark BIKE_2 bas by S.Poole v30nov92, vi8nov2004 
CLEAR: main: STOP 


DEFine PROCedure main 


INIT: OVER 0 
FOR f=1 TO 25: PAPER RND(255): SCROLL RND(f)*-1 
FOR loop2=1 
INK 2,0,1: FILL 1: CIRCLE 84,31,31 : FILL 0 
INK 0 : FILL 1: CIRCLE 84,31,25 : FILL 0 
INK 2,0,1: FILL i: CIRCLE 179,31,31: FILL 0 
INK 0 : FILL 1: CIRCLE 179,31,25: FILL 0 
FOR LOOP=1,4,8,9,2,3,5,6,7 
GET_array: AZIMUT: THRUTURN: TYPEM: FILL 1: DRAW: FILL 0 
IF LOOP='1': INK 0,2,1: FILL 1: CIRCLE 121,25,10: FILL 0 
END FOR LOOP 
PAN RND(1i TO 9)%-1: OVER -1 


END FOR loop2: i$=INKEY$(#1,-1) 
END DEFine 


DEFine PROCedure TYPEM 

FOR f=1 TO dots+3 
s$=sig$(sen(t(f, trn)) ig$(sgn(t(f+1,trn))+2)&' | 
tp=s$ INSTR sg$: t(f, ((tp+2) /3)-1 

END FOR f: t(dots+4, typ) = yp 


END DEFine TYPEM 


+2) &s 
typ)= 
t(4,% 


DEFine PROCedure THRUTURN 
FOR f=2 TO dots+3 
th=t(f,azt)—t(f-1, azt) 
IF the-PI: th=th+rd360 
IF th» PI: th=th-rd360 
t(f,trn)=th 
END FOR f: t(1, trn)=t(dots+1,trn) 
END DEFine THRUTURN 


DEFine PROCedure AZIMUT 

POINT t(1,x),t(1,y) 

FOR f=1 TO dots+3 
jeftl: xx=t(j,x)-t(f,x): yy=t(j,y)-t(f,y) 
dd=SQRT(xx*xx+yy*yy): sx=sgn(xx): sy=sen(yy) 
az=0: IF dd: az=ASIN(yy/dd) 


SELect ON sx 
=1: IF sy=-1: ag=rd360+az 
=REMAINDER : az=PI-az 
END SELect : t(f,azt)=az 
REMark LINE TO t(f,x),t(f,y) 
END FOR f 
END DEFine AZIMUT 


610 : 


620 
630 
640 


DEFine FuNetion sgn(sg) 
RETurn (sg>0)-(sg<0) 
END DEFine 


650 : 

DEFine PROCedure DRAW 

FOR f=3 TO dots+2 
a=f-1: beatl: c=b+1: d=c+1: tipes=t(f,typ) 
ax=t(a,x): ay=t(a,y): bx=t(b,x): by=t(b,y) 
ex=t(c,x): cy=t(c,y): DX=t(d,x): DY=t(d,y) 


660 
670 
680 
690 
700 


710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 


BCx=bx-—cx: BCy=by-cy: MCx=BCx/2: MCy=BCy/2 
Mx=bx~MCx: My=by-MCy 

azb=t(b,azt): azl=(t(a,azt)+azb)/2 
az2=(azb+t(c,azt))/2: az3=azb+RAD(90): ef=1 


SELect ON tipes 
=0,8: L(1,1,x)=bx+COS(az1): L(1,1,y)=by+SIN(az1) 
L(1,4,x)=cx+C0S(az2): L(1,4,y)=cy+SIN(az2) 
L(1,2,x)=bx: L(1,2,y)=by 
L(1,3,x)=ex: L(1,3,y)=cy 
END SELeect 


SELect ON tipes 
=1,2,6,7: bx2=bx: by2=by: cx2=Mx: cy2=My 
L(2,1,x)=bx2+C0S(az1): L(2,1,y)=by2+SIN(az1) 
L(2,4,x) =Mx+COS(az3) : L(2,4,y)=My+SIN(az3) 
L(2,2,x)=bx2: L(2,2,y)=by2 
L(2,3,x)=cx2: L(2,3,y)=cy2 
END SELect 


SELect ON tipes 
=2,3,5,6: bx3=Mx: by3=My: cx3=cx: cy3=cy 
L(3,1,x) =Mx+C0S(az3): L(3,1,y) =My+SIN(az3) 
L(3,4,x) =cx3+C0S(az2): L(3,4,y)=cy3+SIN(az2) 
L(3,2,xX) =bx3: L(3,2,y)=by3 
L(3,3,x)=ex3: L(3,3,y)=cy3 
END SELect 


SELect ON tipes 
=O: TRI 1,0: =1: TRI 2,0: =2: TRI 2,0: TRI 3,1 
=3: TRI 3,0: =5: TRI 3,1: =6: TRI 2,1: TRI 3,0 
=7; TRI 2,1: =8: TRI 1,1 
END SELect 
END FOR f 
END DEFine DRAW 


DEFine PROCedure TRI(TR, CW) 
sax=L(TR,1,x): say=L(TR,1,y) 
sbx=L(TR,2,x): sby=L(TR,2,y) 
sex=L(TR,3,x): scy=L(TR,3,y) 
sdx=L(TR,4,x): sdy=L(TR,4,y) 
spx=sax-sbx: spy=say-sby: sgi=0 
IF spx: sgl=spy/spx: END IF : syl=sax*sg1 
sqx=sex-sdx: sqy=scy-sdy: sg2=0 
IF sqx: sg2=sqy/sqx: END IF : sy2=sex*sg2 
skl=say-syl: sk2=scy-sy2: skk=sk2-sk1: sgg=sg1—sg2 
ix=0: IF sgg: ix=skk/sgg 
sgx=sgl*ix: ly=sgx+sk1 
IF spx=0: ix=sax: iy=scey+(sg2*(sax-scx) ) 
IF sqx=0: ix=sex: iy=say+(sg1*(scex-sax) ) 
IF TR=2: ix=(ixtbx)/2: iy=(iy+by) /2 
IF TR=3: ix=(ixtex)/2: iy=(iy+ey) /2 
REMark INK 2: LINE scex,scy TO ix,iy TO sbx,sby: INK 7 
BCx=sbx~sex: BCy=sby~scy: MCx=BCx/2: MCy=BCy/2 
Mx=sbx-MCx: My=sby-MCy 
mix=ix-Mx: miy=iy-My: im=SQRT(mix*mix+miy%*miy) 
Maj =SQRT(MCx*MCx+MCy*MCy): bm=SQRT(BCx*BCx+BCy*BCy) /2 
ibx=ix-sbx: iby=iy-sby: ib=SQRT(ibx*ibx+iby*iby) 
im2=im*im: ib2=ib*ib: bm2=bm*bm 


dv=(bm2+ib2—im2) /(2*ib¥bm): hi=ib*SIN(ACOS(dv)): sl=TR 
SELect ON sl 
=1: xi=Mx: yi=My: =2: xi=bx: yi=by: =3: xi=cx: yis=cy 
END SELect 
REPeat rp 


IF hi> (Maj¥2.7) THEN 
ix=(ixtxi)/2: iy=(iy+yi)/2: hishi/2 
ELSE EXIT rp 
END IF 
END REPeat rp 


1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
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1910 
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1930 
1940 
1950 
1960 
1970 
1980 
1990 


2000 : 


2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 


Min=hi*.44: ece=Min/Maj 
ELIPTICS: PROJECT 
END DEFine TRI 
DEFine PROCedure ELIPTICS 
LOCal f,j,ct 
ro=0: IF sex<sbx: ro=180 
h=20: REMark SELect ON ece: =.2 TO .5: h=40: =.5 TO 1: h=60: =REMAINDER : h=90 
q=h+1: st=360/h: rot=0 
IF MCx: rot=DEG(ATAN(MCy/MCx) ) 
rot=rot+ro: h=h-4 
hh=h/2: ct=0: SS=-st: AA=180-st: ZZ=st 
IF CW=0: SS=st: AA=-AA: ZZ=-ZZ: et=hh 
DIM u(pp,h+1,y) 


FOR f=AA TO 2Z STEP SS 
IF f=90 OR f=-90 THEN 
NEXT f 
ELSE 
et=cet+1: j=RAD(f) 
Crx=Maj*COS(j): cry=Maj*SIN(j)*ecc 
END IF 
ROTATE Crx,cry: u(ee,ct,x)=Mx+xx: u(ee,ct,y)=My+yy 
ROTATE Crx,O : u(pp,ct,x)=Mx+xx: u(pp,ct,y)=My+yy 
END FOR f 
END DEFine ELIPTICS 


DEFine PROCedure PROJECT 
LOCal f,j,ct: cex=sex: cecy=scy 
IF TR=3: ELSE POINT sbx,sby 
IF CW: j=0: et=hh: ELSE j=hh: ctsh 
nd=j+hh: xa=ix: yaz=iy 


FOR f=j+1 TO nd 
xb=u(2,f,x): yb=u(2,f,y): xe=u(1,f,x): ye=u(1,f,y) 
xd=u(1,ct,x): yd=u(1,ct,y) 
xp=xa~—xb: yp=ya-yb: xq=xce-xd: yq=yc-yd 
gi=0: IF xp: gl=yp/xp 
g2=0: IF xq: g2=yq/xq 
ki=ya-xa*g1: k2=yce-—xe%g2: kk=k2-k1: gg=gi-g2 
xx=0: IF gg: xx=kk/gg: END IF : yy=gl%*xx+k1 
IF xp=0: xx=xa: yy=yc+(g2*(xa-xc)) 
IF xq=0: xx=xe: yy=ya+(g1*(xc-xa)) 
LINE TO xx,yy: et=ct-1 

END FOR f 

IF TR=2: ELSE LINE TO cex,ecy 
END DEFine PROJECT 


DEFine PROCedure ROTATE(rx, ry) 

LOCal rh,sx,sy,ar,rb 

sx=(rx0)-(rx<0): sy=(ry 0)-(ry<0) 
rh=SQRT(rx¥rx+ry*ry): ar=DEG(ABS(ASIN(ry/rh) )) 


SELect ON sx 
=~1: SELect ON sy: 
=0 ; SELect ON sy: 
=+1: SELect ON sy: 
END SELect : rb=ar+rot 


u 


-1: ar=180+ar: : ar=180: =+1: ar=180-ar 
-1: ar=270 : ar=0 : =+1: ar=90 
—1: ar=360-ar: =0: ar=O : =+1: arsar 


oun 
u 


IF rb<O =: rb=rb+360: GO TO 2010 
IF rb>=360: rb=rb-—360: GO TO 2020 
IF rb>270: rb=360-rb: sx=+1: sy=-1: GO TO 2110 


IF rb=270: rb=90 > sx= 0: sy=-i: GO TO 2110 
IF rb>180: rb=rb-180: sx=~-1: sy=—1i: GO TO 2110 
IF rb=180: rb=0 : Sx=-1: sy= 0: GO TO 2110 
IF rb>90 : rb=180-rb: sx=-1: sy=+1: GO TO 2110 
IF rb=90 : rb=90 : sx= 0: sy=+1: GO TO 2110 
IF rb> 0 : rb=rb : Sx=+1l: sy=+1: GO TO 2110 
IF rb= 0 : rb=0 : Sx=+1: sy= 0 


rb=RAD(rb): xx=rh*COS(rb)¥sx: yy=rh*SIN(rb) *sy 
END DEFine ROTATE 


2140 DEFine PROCedure INIT 

OPEN#1, con_128: WINDOW 512,256,0,0 
SCALE 148,44,-8: PAPER 0: INK 4: CLS 
sgeg='++ +0 + 0+ 00 0- + -0 — !: 
ee=1: pp=2: h=20: hh=10 
rdi80=PI: rd360=2*PI: pi2=2*PI 
x=l: y=2: DX=3: DY=4: dist=5: 
2210 END DEFine INIT 


2230 DEF ine PROCedure GET_array 


2240 IF LOOP='1': RESTORE 2480 : READ dots: 
2250 IF LOOP=2 : RESTORE 2510 : READ dots: 
2260 IF LOOP=3 : RESTORE 2540 : READ dots: 
2270 IF LOOP=4 : RESTORE 2570 : READ dots: 
2280 IF LOOP=5 : RESTORE 2600 : READ dots: 
2290 IF LOOP=6 : RESTORE 2630 : READ dots: 
2300 IF LOOP=7 : RESTORE 2450 : READ dots: 
2310 IF LOOP=8 : RESTORE 2420 : READ dots: 
2320 - LOOP=9 : RESTORE 2390 : READ dots: 


2340 DIM t(dots+4, typ) ,L(3,4,2) 
2350 FOR f=1 TO dots: READ t(f,x) 
2360 FOR f=1 TO dots: READ t(f,y) 


SSE ee eee 
RRRR RRR AR 


sig$='-O+' 


azt=6: trn=7: typ=8 


7,2,1: REMark rearleg 
7,4,1: REMark foreleg 
7,4,1: REMark arm 
7,4,1: REMark head 
2,0,1: REMark helmet 
4,2,3: REMark shirt 
2,4,1: REMark short 
4,0,1: REMark frame 
4,0,1: REMark bars 


2370 FOR f=1 TO 4: t(f+dots,x)=t(f,x): t(f+dots,y)=t(f,y) 


2390 DATA 21, 135,142,153,174,190, 194,192,181, 172,171, 176,182,185,179,174,172,166,159 
2400 DATA 155,140,134, 66,68, 71, 76,79,77,75,70, 65,60, 48, 37, 30,25, 30, 37, 50,62, 63, 64,65 


2420 DATA 21, 91,98,105,115,129,149,155,154,149,133,124,114,101, 85, 82,85, 96, 106, 103 


2430 DATA 97,90, 


96,95, 84, 68,67, 66, 65,64,63,53, 39,35, 30,27, 30,33,39,56,75,88,91 


2450 DATA 15, 114,116,119,122,125,138,138,129,123,120,113,104,98.5,100,110.5 
2460 DATA 119.5,116,111,101,98, 91,87, 78.5,74,74,79,87,95, 109,118 


2480 DATA 13, 
2490 DATA 


128, 138,135,129, 136,134.5,127.5,119.5,119,124,125,121.5,120 
82.5, 72,57; 36.5,24.5,17.5,21.5,31.5,38.5,58,69.5,73,77 


2510 DATA 15,126, 139,147.5,146,136,124.5,114.5,119,117.5,107,106.5,114,125,132.5,128 
2520 DATA 90,89.5,82,72.5,64.5,58.5,49, 38.5, 33.5,46.5,55.5,60,69,77, 78.5 


2540 DATA 17, 
2550 DATA 


2570 DATA 11, 


161,164, 169,181, 190,198,202, 203,200,197, 190,176, 165,161, 158,154.5,155 
94,90.5,84.5,82,81, 80, 78, 74,73, 71,73,73,73-5,74,81,87.5,92 


171,181,179.5,178,176,172,171,168, 162,161,164 


2580 DATA 122,111,107,103,103.1,100.5,98.5,99.5,102,112.5,119 


2600 DATA 11, 


149,154, 167,181,184,179.5,171.5,164,160.5,152.5,149 


2610 DATA 125,125.5,127,123,112,106.5,105,108.5,113.5,121.5,123 


2630 DATA 18,116,126, 138,149,160,161, 163,164,160, 154,153,144,133,125,122,121,119,114 
2640 DATA 121,125,127,123,114,108,98.5,91, 88,88,94,98.5,99,101,101.5,104,111,119 
2650 END DEFine GET_array 


In the last issue, we promised to publish more 
information about the SPK in the next issue, Le. 
the one you are reading right now. 

Ralf informed us that he was unable to send us 
the additional information due to health problems. 
So, you need to be patient - it will be in the next 


issue. Meanwhile, a few more "do you remem- 
ber..” pictures for you. 


Ralf writes: 

QL-Cash- Trader 

Written in BASIC using the SPK. A rather com- 
plex program. The original program filled parts in 
the database with zeros, which often led to 
problems using microdrive cartridges. 


QL Intergated Accounts 

Written in C. Semi-professional program for 
book-keeping. The cartridges contain an opcode 
of the program which can be started using the 
SuperBASIC command CRUN. 


QL 
Cash Trader 


The accounting program specifically 
designed for the needs of any small 
business that is based mainly on cash 
rather than long-term credit. 


Most small businesses are:run by people with 

‘ experience in things like marketing, engineering or 
management not by accountants. But keeping 
financial records and: working out the management 
accounts is.often far from easy, particularly when 
most goods and services have tobe paid for as 
they: are supplied, 


@ QL Cash Trader makes financial record-keeping 
simple for peaple who.have many other demands 
on: their time: It also. provides speedy and accurate 
management information, andJets you see the 
effect of each transaction as it happens. 


@ Because financial transactions may occur in a 
random order, you simply update sales, purchases, 
cash payments, standing orders, VAT, expenses, 


and so on, whenever you want. Without you Price: 
“heeding to pre-sort by date or type, QL Cash £69.95 © 
4 Trader instantly processes the entries and displays a re i 
variety of reports — including a Profit and Loss ative T 
account, bank balance, VAT liability, sales and manual) 
ak purchase analysis. 


@  Entries.are made simple witha minimum of : 
typing, and clearly presented report screens keep Software written by: 


you informed. For a view of QL Cash Trader at Accounting 
work, see the reverse of this sheet. Software Ltd. 
A Quest Group Company: 
5503 


Integrated Accounts 5 


A complete package for any business 
which wants to-set up a fully integrated 
ledger-based accounts. system. The 
program also provides a comprehensive 
range of reports, 


Proper book-keeping is essential to any business. 
But; for a:small-business, having it-done. 
professionally can bea major expense. QL 
integrated Accounts makes it possible for anyone 
to organise a properly-managed accounting 
system — saving time and money. 


@ OL Integrated Accounts uses a tried and proven 

method based on the renowned Sage Accounting 

System— one of the UK's top selling accounting 
programs. : 


@ ‘A comprehensive manual and tutorial program 
explain the principles of book-keeping in sucha ake, a 
way:that you.don't need to-be an accountant to ! Price: | 
follow. them. in a very short time, you willbe able | . 

to generate fully-integrated sales, purchase, and. “| £89.95 


nominal ledgers. You.can also request any of a (includes 
suite of management reports, including tral comprehensive. 
balance, profit and loss, VAT, aged debtors and manual) : 
: aged creditors, and a balance sheet. fa EOE 


a Handles up to-300-customer accounts, 
300 supplier accounts, and 
+1000 nominal accounts: Software written by: 


@ Clear graphic screens and simple entries make it. ee 
easy. to use this high-quality, professional program, SAGESCET 
and three months-free ‘Hotline’ support is.provided 


to new users. See how the system: works overleaf. 


Although professionally programmed, there is 
one major drawback: the VAT-rate was not user- 
changeable, only by SAGESoft themself If some 
body has the SAGESoft patch program. please 
report to QL Today, 


Using QL-Cash Trader 


Qt Cash Trader has been designed'so that it 
can be tailored to suit the needs of a wide. 
variety of différent businesses operating in 
virtually-every type of industry: 

. To-make it simple for you to-set up Qk Cash 
Trader the way you want; the program 
contains a variety of example businesses from 
which you choose the appropriate options. A 
comprehensive manual ts included, and this 
starts by-teaching you how to enter typical 
transactions: It also shows:you detailed 
accounts based on a number of different : 
kinds of trading. Should you need additional. |. # You.can make entriesin any order, QL 
help.in.using-QL Cash Trader, there is a: full Cash Trader already knows the date, and 
support service with a free trial period. when you setit up for the first time, you will 

give itinformation such as the name of your ’ 
bank account, and the types of sales and 

purchases. you make, 


..Because the QL now has these details, you 
don't need'to type them in evary.time you: - 
take an entry. You just hold'down.a key.and 

| it will rail through the options to reach the 

one you want: Then all you. do is:to fill:in:the 
appropriate amount, 


‘Before using QL Cash: Trader for your own. 
accounts, the program offers. you the chance 
to run: through the-examples described in the: 
manual. These are worked out on:the main 
screen, which looks like this: The screen is 
divided into anumber of windows, and this 
format is.used for everything which you. do 
with: Qk Cash Trader. 


The window at top left is the Reports 
window. A choice of 18 different @ When you enter the transaction, its effect 
management reports can be displayed here. ».| instantly. appears in the Report window. Any: 

‘On request. in:this example, it shows.a:Profit’: | of the reports canbe printed: out if you wish ~ 
and Loss account and Balance Sheet. ‘| by arrangement with Customs & Excise, you 

The Status window at top right displays youn periie G Cast Trader fo produce 

various items.of helpful information: At 5 
present these are VAT and financial year end. | After eachisession with QL Cash Trader you 
dates; which you set to suit yourself, then save the data (up to. 900 transactions on 


At the bottom is. the Entry window. This is iapebin og until you next want to. update 
where you fill in:-your transactions. You enter 


adescnption of each‘one, the amount; and 
any additional comments: 


Using QL-Integrated Accounts 


The Qt Integrated Accounts package is invoices themselves. Standard entries for 
designed for simplicity, anda detailed things like VAT are: made easy witha single 
manual provides:ail-the book-keeping key press, andiit’s also possible:to duplicate 
imowledge you will need. entnes if they are repeated. 

Even if you have never tackled-accounting When you have completed your entry, you 
betore; you will find that QL integrated are asked to confirm it. The screen data is 


Accounts works.in away. which is easy to then automatically filed.in-the correct places, 

understand. But that doesn’t mean that it cuts ‘ 

any corners in-quality.. The program has been oe ire one oe inthe ledgers dite eaualy 
extensively developed with the aid of to kee var ed 30 you oe te deere 

accountants and Customs & Excise ta‘ensure eep your /edgers up tq date. 

it meets exacting professional standards. 


Qk Integrated Accounts is simple to.use 
because it splits up book-keeping into easy. 
stages. Each of these is clearly explained with “ 

the aid-of examples:to work through; All the a 
screen information is presented so.it is easy to: 
understand, and simple to enter your data. 


The program has two‘main.sections,. 
*Postings’, where you. record invoices, credit 
notes, bank and cash transactions: and. 
*Reports’; which contains:all the routines 
needed to: produce sales, purchase, and i 
jnanagement reports from the posted data. §@ Now you-can:compile: reports from these: 
You start by running the Postings program... | details. The screen. above shows just one of 

the huge range of reports which:is.available - 
a complete analysis. of an account history: 
showing ail the sales invoices and credit note 

tails. 


a Amenu-will offer you-a. choice between 
the sales, purchase, or nominal ledgers. These 
contain options for-creating new-accounts,. | 
and. record eras ot NOt: acai noes “iP Reports:analyses are all based on.an audit 
picture shaws.an: ire os pie of the: screen. used | tail— the most important routine fram-your 
to enter an invoicein the sales ledger. auditor's point of view. As well as providing 

: vital management information, this can-aiso. 
You will already -have set up accounts for } be printed out in:a form suitable for: 
each of your customers. Now, entering the rransferring to your VAT return ~yet another 
invoice details is simply a matter of filling in of the many ways in which Qk Integrated: 
the lines by matching the details to:the Accounts will save you time and: money. 


Your Subscription to QL Today will expire with the next issue. 


You will find a renewal form enclosed with this copy and it would 
help the administration of the magazine if you could complete this 
as soon as possible and return it with your subscription. 
(Subscribers with automatic renewal do not have to return it.) 


Once again costs of both postage and printing have gone up since 
the last renewal but we have decided to hold the price down and 
not increase our cover charges to you so the good news is that you 
will pay the same this year as you did before. 


Please help us to keep costs to a minimum by renewing your 
subscription early. 


The next issue will contain an interesting Sudoku article from 
Norman, a report about the Quanta AGM, the latest Psion XChange 
developments, a hardware article and much more! We are also 


waiting for YOUR submission - please see deadline on page 2. 


First column of a New Year so it Is time to look 
back over the last twelve months and see what 
it brought us. Well the truth is quite a lot really, 
New programs and a few updates to old ones 
with one or two little bonuses left dangling at the 
end of the year to tempt us forward. 

Usually | am one of those tardy people who 
leave their UK Tax Return to the last moment but 
this year | managed to move that last moment a 
couple of weeks forward so | actually had some 
time to look into the figures for both the 
2003-2004 and 2004-2005 tax years before 
suomitting the documents. 

Sad to say, sales at the QBranch emporium were 
down on both years but the figures for the items 
we did sell were quite interesting. The most tel 
ling of the figures was for the 2004-2005 tax 
year In spite of the conclusions based on the 
results for the survey that was conducted last 
year my overwhelming best seller was QPC2, 
closely followed by QPCPrint. | did have some 


second user QL hardware items and some QL 
Membranes for sale but these only moved very 
slowly at first indicating that those who do still 
use native hardware may have all they need. 
Among the other programs on sale the 187 
patch program did quite well and QDT made a 
Strong showing. Sales for upgrades for Easyptr 
were not so good - certainly not deserving of the 
hard work Marcel put into it but that was always 
to be expected since, only a handful of current 
QL Users, really like to get their hands dirty with 
code. 
This seems to say to me that many QL Users 
now have QPC2 on a PC in some form and, 
certainly amongst those who attend the work- 
shops, a large number of these use a laptop for 
their QPC2 platform. | began to wonder what 
they actually used it for since there have been 
few really new utility programs for SMSQ/E in the 
last few years. 


What Makes A Program Good? 


in part, some of this curiosity was satisfied by a 
user who came over to me so |! could solve a 
few hardware problems he had with his QL. He 
was using Abacus to run a series of spead- 
sheets and said that he had a PC at home but 
that Abacus ‘beat Excell hands down. Now that 
is clearly a very subjective viewpoint and not one 
that many people will hold - myself included. | 
have always found that Excell is one of the best 
programs in the Microsoft stable (probably be- 
cause they did not write it - they bought it in from 
another software house). There is no doubt that it 
is more powerful and has more facilities than any- 
thing that we have to offer. 

The key to this, however, lies in the simplicity of 
use. If you know how to set Abacus up then it is 
quicker to use that than to try to get to grips 
with a new program - especially when the new 
features in that new program will not be needed 
for the things you need to do. There was a move, 
some years ago now, to release some ‘simple’ 
versions of the Microsoft Office suite at a re- 
duced price for people like this but, apart from 
‘Works’ (and even this has a full version of Word 
in it) | have seen little evidence of it being pushed 
forward. 

There is a tendency on the part of programmers 
to assume that the more features, bells and whis- 
tles they can build in the better the finished pro- 
duct will be. This is the Swiss Army Knife ap- 
proach to programming that has seen so many of 
the commercial PC programs bloat up like a 
bunch of weight watchers on ‘Sod it all, why not?’ 
day. 

When we started QBranch, over 10 years ago 
now, we used to boast that all of our leaflets, ad- 
verts and other material were produced using QL 
software. That, alas, is no longer the case. Some 
of this is due to issues outside my control, some 
people need files in more standard formats for 
instance, but | do still use QD to write this column 
and | do use LINEdesign to make the QL Today 
adverts in preference to Adobe Illustrator which | 
also own and use for the Quanta ads. 


Help - What Help? 

The situation with non-QL programs is not helped 
by their complete lack of manuals. (I did, much to 
my surprise, get a manual with Dreamweaver 
when | bought it last year) | have, for instance, just 
spent an entire afternoon searching the online 
help for Adobe Acrobat Professional trying to 
find how to make an editable pdf file which will 
calculate the values as you enter them. The on- 
ine helo was next to useless. Most QL programs 


come with good readable manuals and even 
those like QDT and QPCPrint and now QPC2 
which has just been released in CD form for 
users with no floppy drive, which have manuals 
on disk are easy enough to follow. 

Of course, we have grown up with the QL pro- 
grams sO we understand the concepts and the 
terminology. A user who switches to a PC finds 
something which has been evolving behind his 
back and he Is in allen territory from the start. 
This goes a long way towards explaining why 
many of us stick with older programs when the 
newer ones sometimes offer us more. Even 
those within the QL scene. 

Having written the above, the engine of Seren- 
dipity swung into action and the QL Users list on 
the Internet prompted lan Pizer to write that he 
wanted to sort a list alphabetically but could no 
do it on his PC so he dropped it into QL mode 
and did it there with no problem. Hurrah for the 
QL you may be tempted to say until someone 
pops up and says ‘This is how you could have 
done it in DOS’. You see it is all a question of 
where you came from. If you started on a QL 
then QL ways always seem to be the best. 
Marcel recently did some hacks to improve 
Xchange and Roger Godley has been doing 
similar things with the original PSION suite to 
make them nicer to look at and more functional. 
Whilst | can only applaud these improvements it 
must be admitted that Quill is no more useful than 
the Wordpad program that comes with Windows 
- less so because it lacks a spell checker or 
different fonts. It is, however. infinitely smaller. It all 
depends on what you want. 


— 


Crossover. 
Of course, one of the aspects that most befud- 
dles users when changing from a QL in a black 
box with two hard drives is the fact that they 
now have to actually learn something new. This 
is, in part, one of the factors that led me to write 
the ‘Start Here’ series. A case in point is a custo- 
mer who bought QPC2 from me in February. For 
a long time he has used his QL in tandem with 
his PC with both machines doing different jobs 
but he now wanted to run both things on one 
machine. Although, when he started out with his 
QL, he felt confident enough in his knowledge of 
SuperBasic to submit a program to a magazine 
for publication, his use of the QL for the last few 
years has been to run Quill and Abacus so he 
has forgotten all of the programming skills he 
had. 
His drives, which worked well on his QL, pro- 
duced disks which would not work on his PC and 


he had no idea how to move the data. Even 
when the data and the programs had been 
moved it was clear that he would be struggling 
to write a coherent BOOT file and incorporate all 
of the things he needed to make the system run 
smoothly. Teaching him how to do this would be 
a long, and ultimately unprofitable, job but this is 
what he needed. He was not a QL Today or 
Quanta reader because he had little use for the 
things it was talking about’ (except, of course, 
learning how to use the new technologies, wri- 
ting a BOOT file and alll the other things that we 
cram into these pages. Oh Well) but he clearly 
needed help. | spent a few hours with him trying 
to get him to the stage that it would all work cor- 
rectly, including changing one drive so he could 
produce disks that his laptop would recognise 
and trying to nudge him into looking at newer QL 
programs to use. What alternative was there? | 
could just leave him to it and let him carry using 
his high powered laptop like a QL and inserting 
disks in the drive, booting from them, and running 
as before but then his experience of the power- 
ful QPC2 program would be inadequate and it 
would be selling Marcel's work short. 
So, | put in the time teaching him stuff, loading 
Xchange for him, showing him how to set things 
up before he left. He still has to jump the printer 
hurdle so | suppose | will hear from him again but 
he will, at least, be getting a little more from his 
QPC2 purchase. That is, of course, what we are 
about isn't it? 

This, of course, brought up that old incompatibility 
issue again, only written very large and it is a 
barrier that many people who have been running 
old black boxes come across when they try to 
get their old programs and data onto an emulator. 
This applies to all emulators, not just QPC2. | was 
left wondering about the possibility of a piece of 
hardware to make things easier. Of course that is 
mainly pie in the sky now that Nasta does not 
seem to be making any progress with his pro- 
jects but, just for a hypothetical exercise what 
could we do? 


Thought Experiment 

In the early days of Quantum Physics many of 
the leading scientists such as Neils Bohr, conduc- 
ted what they called ‘Thought Experiments’ (a 
phrase thought up by Ernst Mach in the 19th 
Century) in which they tried to conjure up the 
results they would get if they were able to have 
the equipment they needed or were physically 
able to measure sub-atomic particles. In our case 
of transferring data from a black box with a faulty 
disk drive or perhaps even a microdrive, what 
could we do? 


Direct cable transfer is one option but Sernet has 
to be ruled out because it requires SMSQ/E and 
that will not run on a QL unless it has a minimum 
of a Gold Card. Simon Goodwin could probably 
help here because | do believe there was some- 
thing in his DIY toolkit which would allow serial 
transfer One other answer would be QTPI con- 
nected to the Windows Hyperlerminal program. 
This is a route worth considering but the user 
would have to make up the cables to do It and 
that is not so easy - especially since the QL style 
serial plugs are hard to get. Maybe SuperHermes 
and a special cable from Tony Firshman or a 
special DATA Transfer version of SuperHermes 
Lite? 

Disk transfer would be OK if the disks are read- 
able by the PC but, in the above case that is not 
possible and, in the case of a microdrive-only ma- 
chine, the user would need to get a disk interface 
and set of drives that could be read - not easy 
these days. 

Other hardware solutions are even more unlikely 
but, since this is a thought experiment we can 
launch into them. We already have the ROMDisq 
but that is still in QL format and cannot be directly 
read by a PC but how about a ROM to Compact 
flash adaptor? Compact Flash is the best way to 
do this because it is, at it's heart, an IDE device. 
the device would need an interface that would 
accept Inout and Output, to and from the QL’s 
ROM port and output to an IDE device. Almost 
the same idea that Miracle had many years ago 
except that they were dealing with MFM and RLL 
drives in those days and not IDE. We would also 
need some software that would create a 
QXLWIN file on the Compact Flash or if the user 
was able to format and create the appropriate file 
on his PC, just to write to it and read from it 

One other, even more unlikely idea, is a RomDisq 
to PC interface. | suppose this would have to be 
some kind of USB device and would need a lot of 
PC software and firmware to be written to allow 
the PC to see the device and make it available to 
the underlying emulator. 

Finally, the most outlandish idea of all. A stand 
alone device that would accept a Compact Flash 
card and a ROMDisq. Push a button on the de- 
vice to transfer DATA from one to the other. 

Well, they are all thought experiments, and | have 
no idea of the feasibility of designing and building 
them. It would be nice if someone could take 
these subjects up and produce an article on 
getting data from a QL to an emulator Maybe 
several people could write something and we 
could lump it all together as a part of the Start 
Here series. 


Now, how about it Tony and Nasta? Get you 
designer's hats on and implement one of the 
hardware devices. 


Microsoft Land 

Digressing into Microsoft Land for a brief para- 
graph or so, the QL users list was recently invited 
to look at Tarquin Mill's website, www.oftme.uk in 
which he lampoons the Office of Fair Trading in 
the UK for not attacking Microsoft for being 
unfair Now it does seem to me that there are 
issues to be advanced in this direction but the 
major problem is that, like the giant supermarkets, 
Microsoft has grown so huge that it does not 
matter how many Don Quixote wannabes launch 
themselves at its flanks, all it will do is belch and 
turn the other way slightly. That other great 
Behemoth, the EU took it on over the last few 
years like some Harryhausan Clash of the Titans 
epic. They wasted a colossal amount of tax- 
payers money forcing the company to provide 
other versions of its software which did not have 
the media player built in. | work in a company that 
sells Microsoft products and no one has ever 
asked for this copy of Windows. As a result of 
this legislative overkill the new version of its O/S, 
to be called Vista, will come in more than 8 diffe- 
rent versions but will anyone make any great dis- 
tinction between them? People still buy XP Pro- 
fessional because it has the word ‘Professional’ in 
its title but they are unlikely to use or in some 
cases, even understand, why they forked out the 
extra cash over the ‘Home’ version. 

More to the point here as the EU forces Micro- 
soft into opening up its code to its rivals, in a dif 
ferent part of the building tries to foist its Intellec- 
tual Properties copyrights law onto the books 
which will almost make it illegal to think about 
writing a program with a similar concept to one 
already written. This kind of Carlos the Jackal 
and Mr Hyde, double standards baffles me. After 
all why is there only one European Parliament? 
should we not have a few different ones so the 
public can choose which laws they want and 
maybe buy those. Now there is an interesting 
political system to think about. True market forces 
at work. 

Tarquin implies that Microsoft was somehow in- 
strumental in the demise of the small computer 
systems of the 80's but they had a pretty good 
death wish themselves. Back then the systems 
were proprietory and inward looking. There were 
few attempts to get a coherent system of com- 
munication between rival systems, partly, | sus- 
pect, because they could not see the need for it 
and partly because they did not want anyone 


straying from the system they were using. Sin- 
clair itself, was going through its oddball inventor 
stage, producing strange vehicles that ran on hair 
dryer motors and paying no attention to its core 
electronics market. It botched the launch of the 
QL as we all know and pretty much signed the 
systems death warrant at an early stage. Cuddly 
Alan Sugar, only slightly less appealing than a 
room full of wasps, did the rest. He bought out 
Sinclair to get his hands on the successful Spec- 
trum and to bury the QL which he saw as a rival 
to his Amstrad business machines. As it was they 
both swirled down the toilet because IBM and 
then Microsoft had hit on the idea that offices all 
over the world would like to be able to share 
files and the, now global, dominance of Windows 
based systems began, 

Tarquin also points the finger at Microsoft for 
holding LINUX back but LINUX did a pretty good 
job of that itself by making itself the geek's 
pin-up. It is not the great skill of the programming 
or the accessibility of the code that makes 
people rush out and buy the system. It is how 
pretty it looks, how well it is marketed and how 
successfully you can convince the people that 
they really need to enough bells and whistles to 
drown out a Football stadium in full voice. Oh yes, 
and where is ‘Grand Theft Auto’ for LINUX then? 
lt would seem to me to be pointless to rail, rant 
and tear your clothes in frustration over the 
wrongs, real or imagined, that you may think 
Microsoft has done to you. Why not put that 
energy into making your own system better? Put 
enough termites in the cellar and even the 
strongest foundation will collapse. 


Fex and Friction 

| think that Per Witte may have got the wrong 
end of the stick when | mentioned his use of the 
FEX keyword. | was not complaining about him 
but about the way in which the system for moni- 
toring the progress and enhancements for 
SMSQ/E are implemented. The whole reason | 
fought tooth and nail to get the licence for 
SMSQ/E adopted was to keep it regulated so 
that conflicts did not happen. | also wanted to 
make sure that things that were written for one 
platform would either work on another platform 
or at least not cause a fatal error This is a 
Herculean task and one not to be undertaken 
lightly and Wolfgang Lenerz has done a good 
job in trying to keep it in check and to make tt 
work for the majority of cases. On this one 
occasion it fell down because no-one knew that 
FEX was used in other programs but, even then, 
it stil worked until a new version of Fileinfo 2 was 


launched - correcting the FEX keyword. in my 
opinion this was the wrong approach. Once a 
keyword has been introduced and accepted it 
should never be changed for any reason. You 
never know who might have used that keyword 
or where it may cause a program to fall over If 
this had just been an oversight it would have 
been excusable but it was not. It was recognised 
that FEX had been used before and it should 
have been rejected as a new keyword and 
mentioned in the SMSQ/E documentation. 

It is not Per's fault but it is a ‘heads up’ for the 
way in which SMSQ/E is regulated. You never 
can tell where these things are used so avoid 
duplication in the future. 

It was used in Disk Mate 5, an underestimated file 
handling program which sees a lot of use here 
at QBranch HQ. It was because | use Disk Mate 5 
a lot that | noticed it when Thierry changed 
things in the new version of Filelfo 2 and dropped 
FEX from the extension that is loaded at the 
Start. You can actually re-insert the FEX keyword 
by a change in the config block of Fileinfo 2 but 
that, of course, will mean that future programs 
using the new version of FEX will fall over Can 
someone hack DM5 to change the command? 
That would solve the problem this time but a 
esson should be learned here. Compatibility is 
more important than innovation. 

t Is interesting to note that after Per put his 
hands up and said he was the guilty party both 
Dilwyn and Francois van Emelen started discus- 
sing lists of keywords on the QL Users lists. | 
have often wondered who reads the stuff | write 
and, if all | have managed is to get this discussion 
started, it is worth all the hours | put into it. 


Another Issue 

| have been asking readers of this magazine if 
they would rather it were on time and maybe a 
little thin because articles were late or had a 
reasonable standard of content and came out a 
little late. People seemed overwhelmingly for the 
former position because it did keep the News’ 
section as real news as well as being predictable 
in its publication time. Jochen and | discussed this 
and decided that, from this issue on, we would 
set a publication date and publish that at the 
bottom of the last page where the shows are 
announced. That way you should all know when 
to expect it to arrive. 


Honourable Mentions and Flags 
at Half Mast 


| mentioned at the start of this about the very 
beginnings of QBranch, over 10 years ago now, 


and it was shortly after writing those words that | 
got the news about the death of Steve Hall who 
was QBranch's co-founder | have written a formal 
obituary which appears elsewhere in the maga- 
zine but | also think it is fitting that | should give 
him an honourable mention here too. Without his 
help and enthusiasm in the early days we might 
not have got off to the start we did. He was 
present through most of the early days of the 
company, taking over the reins when | was away 
on my Rock'n Roll jaunts. Later when | was 
running the Bank Volt, he got involved there too 
spending many late hours building systems and 
sifting through the second user hardware we 
accumulated. Neither of us made much from all 
that work but he never complained. 

| attended his funeral and it was typical of him to 
have the Monty Python song ‘Always Look On 
The Bright Side Of Life’ playing as we entered 
the crematorium and to have the ‘Thunderbirds 
are GO: countdown played as his coffin set off to 
the flames. In the addresses that people gave 
they all mentioned his indefatigability and how he 
would always see a problem as a challenge. | 
was reminded of him strongly the evening of the 
funeral when the QL User | mentioned above, 
who had a particularly ancient set of drives and 
interface called round. He had bought QPC2 but 
the disks, which were perfectly readable on his 
QL were impossible to read on his PC. As | sat 
there trying to fit a modern drive to one of his 
older ones so he could transfer the data to that, 
and struggling to overcome cables that were the 
wrong way round and power lines that were too 
short | realised that it was that need to make 
things work that we had in common although, on 
the practical side of things, he was always a 
craftsman, whereas | would often bodge it to 
work. 
Above all he was a friend and good fun to be 
with. In the 12 years | knew him we never fell out 
once and, if we weren't debating politics or com- 
puter hardware and software we were often 
laughing. | took it upon myself to call round the 
Sussex QL User group and inform them of his 
death and they all had similar feelings about him. 
You may not really know some of the things he 
got started or some of the ideas that he put into 
the community because he tended not to be so 
outspoken about himself, but he deserveres this 
final salute from myself the Sussex QL Users 
Group and from the many customers whose QL 
problems he solved and to whom he gave good 
advice. 

Bye my friend. 


Stephen Hall 1955-2006) 


News has just reached me of the sudden 
death by heart attack of Stephen Hall aged 50. 
Some years ago, when | was about to move 
from Hamburg, in Germany, back to the UK, | 
put a letter in Quanta asking if there were any 
QL users in Brighton. Steve responded to that 
and we met up soon after | arrived here. We 
became firm friends and remained so until his 
death. Steve was one of the pivotal figures, 
along with Keith Mitchell, in the resurrection of 
the Sussex QL Users Sub Group and was my 
partner in QBranch from the start. In fact, he 
gave the name to the company in a drive 
along the Worthing seafront to meet up with 
John Wakefield for an interview for a QL 
publication. 

Steve was always a good person to spend 
time with and we had many enjoyable times 
together travelling to QL shows in the 90's. Al- 


Dietrich Buder (1932-2006) 


Many QLers around the world will remember 
Dietrich Buder, as he visited many QL shows, 
even the ones in the USA and Canada. 

| heard about his illness when Dietrich had to 
cancel one of the regular visits of the US QL 
shows some years ago. Luckily, he recovered 
as the medicine seemed to have helped. So he 
came to the show the next year and to some 
shows in Europe, but in the end his illness won. 
| have Known Dietrich for many years as he 
was an enthusiastic QLer right from the start. 
He was not just a customer we became 
friends, and especially when we travelled to 
gether with his wife and my girlfriend. We 
spent several days every holiday together - 
very enjoyable times. 

Dietrich was also the helping hand for the 
German QL Today, especially proof reading. | 
heard at his funeral, that he was very encou- 
raged in the German language, the new spel- 
ling etc. and even founds “bugs” in the main 
German dictionary. 

Dietrich has always been very interested in 
technical things, and not just computing. Music, 
model trains and travelling are part of the list. 


though we were diametrically opposed politi 
cally we were always able to have good-na- 
tured and intelligent discussions which passed 
the time on the road enjoyably, As far as the 
QL went he was instrumental in getting Rich 
Mellor to write QRoute and in getting Ma- 
sterSpy and some other programs available. 
Although his interest waned over the last few 
years we remained 
good friends and con- 

tinued to stay in contact. 

He taught me a_ lot 

about the QL and, like 

everything else he did 

in his” life. he ap- 

proached every project 

with intelligence and un- 

derstanding. 

He leaves a wife and 

two teenage sons. |, for one, will miss him. 
Roy Wood. 


From what | heard, Dietrich had an interesting 
life all the time, before and while | knew him. 
He travelled a lot, and he continued to travel 
as long as his illness allowed it. 

Especially the EXPO 2000 (World Exhibition) in 
Hannover very close to where he lived, al- 
lowed him to visit the remaining parts of the 
world without driving or flying. He spent 
nearly every day at the EXPO. 

Dietrich liked the USA and found several 
friends over there as well. He also liked the 
fact that smoking was strictly forbidden in 
public places and restau- 

rants and he hoped that 

this would become fact 

here as well. We dis- 

covered that he recently 

made a_ statement in 

public, which you can 

see and hear yourself - 

just google for ‘Dietrich 

Buder’ to find the video. 

There are so many 

things, both QL-related and not QL-related, 
which will always remind me of Dietrich himself 
or the time we spent with him. | am glad | 
knew him. Jochen Merz 


The Quanta 2-day Workshop & AGM 


Venue: 3rd Davyhulme Scout Headquarters, 

Conway Road, Davyhulme, Manchester, UK 
Sat., 8th April 12pm - 5pm and Sun., 9th April at 10am to 4pm 
: The AGM will be held at 2pm Sunday April 9th 2006 | 
1| Hotel accommodation is in short supply that weekend as there is a Man|| 
|} U/Arsenal football match on Sunday. Our usual hotels are already full. There are | | 
|| vacancies at the Mersey Farm Premier Lodge in Sale, Tel No 08701 977 179 | 
|| Directions to the venue by Road; From the M60, Leave at Lostock Junction 9, || 
1} and take Lostock Road, towards Urmston. Pass the George H Carnall sports | | 
I} centre and take the next turn to the right, Conway Road. 3rd Davyhulme HQ is at || 
|| the bottom of the road on the right hand side. | 
We hope to arrange a programme of presentations and demonstrations for the || 
Sunday before the AGM starts. If you have any topics that you would like to 
know more about, please contact John&Sarah Gilpin: theGilpins@btinternet.com 


The Hove Quanta Workshop 
Portslade Townhall, UK - Sunday, 28th of May 2006 
1} This will be the 10th Birthday of the Annual Hove Quanta Workshop. |} 

After a couple of years in very unsatisfactory Hotels we settled upon || 
|; the Portslade Town Hall venue which has proved to be very popular with || 
H}both visitors and traders. As usual the catering will be provided by our |] 
1} usual bunch of lovely ladies and we hope that the weather will be good |j 
[|| enough to encourage those of you not from the area to come down for a || 

weekend by the sea. Hotels do get booked up so do plan ahead! | 
Hj! am looking for people who would like to give a talk, or demonstration |} 


|| during the show. Any suggestions or volunteers should contact me via Q Branch, | 


| We plan to have the next issue ready for you at the Hove Quanta workshop, | 
28th of May. If you cannot pick it up there, then your issue will be on its | 
| way to you right after the show. 
| And to ensure the issue can be ready, please send your contributions for | 
| the next issue to us before the deadline, 1st of May. 2 


